Create currency pair

Creates a new pair or pairs of currencies.

post

Body

Bulk operation data model

Responses

200

OK

application/json

Represents a pair of currencies in exchange module.

revisioninteger · int32Optional

idstringOptional

The unique identifier of the pair.

namestringOptional

The name of the pair.

externalIdstring · nullableOptional

The external id of the pair

notesstring · nullableOptional

Notes for the pair

primarybooleanOptional

If the pair is primary

agreementsinteger · int32Optional

Number of agreements

ratesinteger · int32Optional

Number of rates

statusstring · enumOptional

Rate status enumeration

Possible values:

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

post/public/v1/exchange/pairs

POST /public/v1/exchange/pairs HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 1425

{
  "data": [
    {
      "audit": {
        "created": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "deleted": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "revision": 1,
      "id": "text",
      "name": "text",
      "externalId": "text",
      "notes": "text",
      "primary": true,
      "reverse": {
        "revision": 1,
        "id": "text",
        "name": "text",
        "externalId": "text",
        "notes": "text",
        "primary": true,
        "latestRate": "[Circular Reference]"
      },
      "sourceCurrency": {
        "icon": "text",
        "revision": 1,
        "id": "text",
        "name": "text",
        "code": "text",
        "precision": 1
      },
      "destinationCurrency": {
        "icon": "text",
        "revision": 1,
        "id": "text",
        "name": "text",
        "code": "text",
        "precision": 1
      },
      "latestRate": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "deleted": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "icon": "text",
        "revision": 1,
        "pair": {},
        "recordDate": "2026-01-01T00:00:00.000Z",
        "value": 1,
        "externalId": "text",
        "status": "Active",
        "reverseRate": {
          "id": "text",
          "icon": "text",
          "revision": 1,
          "value": 1,
          "externalId": "text"
        }
      },
      "agreements": 1,
      "rates": 1,
      "status": "Active"
    }
  ]
}

[
  {
    "audit": {
      "created": {
        "at": "2026-01-01T00:00:00.000Z",
        "by": {
          "id": "text",
          "name": "text",
          "icon": "text",
          "revision": 1
        }
      },
      "updated": {
        "at": "2026-01-01T00:00:00.000Z",
        "by": {
          "id": "text",
          "name": "text",
          "icon": "text",
          "revision": 1
        }
      },
      "deleted": {
        "at": "2026-01-01T00:00:00.000Z",
        "by": {
          "id": "text",
          "name": "text",
          "icon": "text",
          "revision": 1
        }
      }
    },
    "$meta": {
      "omitted": [
        "text"
      ]
    },
    "revision": 1,
    "id": "text",
    "name": "text",
    "externalId": "text",
    "notes": "text",
    "primary": true,
    "reverse": {
      "revision": 1,
      "id": "text",
      "name": "text",
      "externalId": "text",
      "notes": "text",
      "primary": true,
      "latestRate": {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "deleted": {
            "at": "2026-01-01T00:00:00.000Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "icon": "text",
        "revision": 1,
        "pair": "[Circular Reference]",
        "recordDate": "2026-01-01T00:00:00.000Z",
        "value": 1,
        "externalId": "text",
        "status": "Active",
        "reverseRate": {
          "id": "text",
          "icon": "text",
          "revision": 1,
          "value": 1,
          "externalId": "text"
        }
      }
    },
    "sourceCurrency": {
      "icon": "text",
      "revision": 1,
      "id": "text",
      "name": "text",
      "code": "text",
      "precision": 1
    },
    "destinationCurrency": {
      "icon": "text",
      "revision": 1,
      "id": "text",
      "name": "text",
      "code": "text",
      "precision": 1
    },
    "latestRate": {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "deleted": {
          "at": "2026-01-01T00:00:00.000Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "icon": "text",
      "revision": 1,
      "pair": {
        "revision": 1,
        "id": "text",
        "name": "text",
        "externalId": "text",
        "notes": "text",
        "primary": true,
        "latestRate": {
          "id": "text",
          "audit": {
            "created": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "updated": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            },
            "deleted": {
              "at": "2026-01-01T00:00:00.000Z",
              "by": {
                "id": "text",
                "name": "text",
                "icon": "text",
                "revision": 1
              }
            }
          },
          "$meta": {
            "omitted": [
              "text"
            ]
          },
          "icon": "text",
          "revision": 1,
          "pair": "[Circular Reference]",
          "recordDate": "2026-01-01T00:00:00.000Z",
          "value": 1,
          "externalId": "text",
          "status": "Active",
          "reverseRate": {
            "id": "text",
            "icon": "text",
            "revision": 1,
            "value": 1,
            "externalId": "text"
          }
        }
      },
      "recordDate": "2026-01-01T00:00:00.000Z",
      "value": 1,
      "externalId": "text",
      "status": "Active",
      "reverseRate": {
        "id": "text",
        "icon": "text",
        "revision": 1,
        "value": 1,
        "externalId": "text"
      }
    },
    "agreements": 1,
    "rates": 1,
    "status": "Active"
  }
]