List Orchestration Rules

List all orchestration rules, optionally filtering and paging the results.

By default, orchestration rules are returned in reverse chronological (descending) order by creation time. If no query parameters are supplied, the response will include up to the last 100 rules which were created.

The paginated results default to display up to 100 rules, unless otherwise specified with the limit parameter. The maximum limit value is 1000. Every paginated response contains a next_page_cursor field until the last page is reached.

Pass the next_page_cursor value into the page_cursor field of a new request to retrieve the next page of results.

Rules can be filtered by:

• Profile ID (profile_id)
• Status (status)
• Source asset (source_asset)
• Destination asset (destination_asset)

GET /orchestration/rules

List Orchestration Rules

cURL

curl --request GET \
  --url https://api.paxos.com/v2/orchestration/rules \
  --header 'Authorization: Bearer <token>'

200

{
  "rules": [
    {
      "id": "<string>",
      "ref_id": "<string>",
      "nickname": "<string>",
      "profile_id": "<string>",
      "identity_id": "<string>",
      "account_id": "<string>",
      "source_asset": "<string>",
      "destination_asset": "<string>",
      "source": {
        "crypto": {
          "address_id": "<string>",
          "address": "<string>",
          "network": "<string>"
        },
        "fiat": {
          "deposit_instructions_id": "<string>",
          "network": "<string>",
          "account_type": "<string>",
          "memo_id": "<string>"
        },
        "profile": {
          "profile_id": "<string>"
        }
      },
      "destination": {
        "crypto": {
          "address": "<string>",
          "network": "<string>"
        },
        "fiat": {
          "fiat_account_id": "<string>",
          "memo": "<string>"
        },
        "profile": {
          "profile_id": "<string>"
        }
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_page_cursor": "<string>",
  "items": [
    {
      "id": "<string>",
      "ref_id": "<string>",
      "nickname": "<string>",
      "profile_id": "<string>",
      "identity_id": "<string>",
      "account_id": "<string>",
      "source_asset": "<string>",
      "destination_asset": "<string>",
      "source": {
        "crypto": {
          "address_id": "<string>",
          "address": "<string>",
          "network": "<string>"
        },
        "fiat": {
          "deposit_instructions_id": "<string>",
          "network": "<string>",
          "account_type": "<string>",
          "memo_id": "<string>"
        },
        "profile": {
          "profile_id": "<string>"
        }
      },
      "destination": {
        "crypto": {
          "address": "<string>",
          "network": "<string>"
        },
        "fiat": {
          "fiat_account_id": "<string>",
          "memo": "<string>"
        },
        "profile": {
          "profile_id": "<string>"
        }
      },
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

OAuth Scope

orchestration:read_orchestration_rule

Authorizations

Authorization · string · header · required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

• Production: https://oauth.paxos.com/oauth2/token
• Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Query Parameters

profile_id · string

Optional filter by profile ID

status · enum<string>[]

Optional filter by statuses

• ACTIVE: The rule is active, deposits matching the source_asset and source of this rule start a conversion and subsequent delivery of the destination_asset to the specified destination.
• DELETED: The rule has been deleted, newly deposited source_assets to the source of this rule will not be converted. The deposited source_asset is still going to be credited to the Profile specified by profile_id.
• PENDING: The rule creation is pending approval(s) before the rule becomes ACTIVE.
• REJECTED: The rule creation has been rejected during the approval process.

Available options: ACTIVE, DELETED, PENDING, REJECTED

source_asset · string

Optional filter by source asset

destination_asset · string

Optional filter by destination asset

ids · string[]

Optionally filter by the UUIDs of the orchestration rules. Limit 100.

limit · integer<int32>

Number of results to return. Defaults to 100 if no limit is provided. Maximum 1000.

order · enum<string>

Sort order for the results. Defaults to DESC by created_at time.

Available options: DESC, ASC

page_cursor · string

Optional Cursor for getting the next page of results.

Response

200 - application/json

A successful response.

rules · object[]

Deprecated: Use items instead. This field will be removed in a future version.

Show child attributes

next_page_cursor · string

items · object[]

Show child attributes