REST API›Settle (Off Exchange)›Partner Activation

GET

List Partner Connections

Returns all your OES connections. For use only by OES partners.

Error scenarios:

  • 400: Invalid Request Error

  • Occurs when the request parameters are invalid or malformed.

  • Examples: Empty string provided for enterpriseId. Invalid query values.

  • 401: Authentication Error

  • Occurs when the request is not authorized.

  • Examples: Caller is not a member of the enterprise.

  • 403: Permission Denied Error

  • Occurs when the authenticated partner doesn't have necessary permissions.

  • Examples: Enterprise does not have OES license.

  • 404: Not Found Error

  • Occurs when the specified enterprise cannot be found.

  • Examples: Enterprise ID doesn't exist or doesn't belong to the partner.

  • 500: Internal Server Error

  • Occurs when there's an unexpected server error processing the request.

  • Examples: Database connection issues, error retrieving connection data.

Requires access token scope: settlement_network_read

Path Params

  • enterpriseId string required

    at least 1 characters

Query Params

  • pageNumber string integer
    The page number (integer) you wish to fetch. When provided, the API will skip pageSize * pageNumber records. Page numbers are zero-based, so the first page is 0. If not provided, defaults to 0.
  • pageSize string
    The page size (integer) you wish to fetch. When provided, the API will return at most pageSize records per page. If not provided, a default page size defined by the server will be used.
  • active boolean
  • clientIds array of strings
  • connectionIds array of strings
  • partnersClientIds array of strings
  • partnersConnectionIds array of strings
  • partnerIds array of strings

Responses

200
OK

Response Body

object

  • connections array of objects required
    connections object
    • id string required
      The unique identifier of the connection. This UUID uniquely identifies the connection between a client and partner.
    • name string required
      A user-friendly name for the connection. This is a descriptive label provided by the client for this particular connection.

      at least 1 characters

    • clientId string required
      The unique identifier of the client associated with this connection. This UUID uniquely identifies the client organization within the BitGo system.
    • partnerId string required
      The unique identifier of the partner associated with this connection. This UUID uniquely identifies the partner organization within the BitGo system.
    • networkAccountId string required
      The unique identifier of the network account associated with this connection. This references the account where allocated funds are held for this connection.
    • createdAt string date-time required
      The date and time when the connection was created. Represented as an ISO 8601 formatted date string.
    • updatedAt string date-time required
      The date and time when the connection was last updated. Represented as an ISO 8601 formatted date string.
    • active boolean required
      Indicates whether the connection is active. When false, the connection is deactivated and no operations (like allocations) can be performed on it. When true, the connection is active and operations can be performed on it.
    • proof string required
      The cryptographic proof associated with the connection. This is used for verifying the authenticity of the connection. Derived from the payload and signature submitted when the connection was created.

      at least 1 characters

    • nonce string required
      A nonce value used in the connection cryptographic operations. This provides additional security for connection operations.

      at least 1 characters

    • evaluationId string
      The unique identifier of the policy evaluation for this connection.

      at least 1 characters

    • pendingApprovalId string
      The unique identifier of the pending approval for this connection.

      at least 1 characters

    • policyResult string enum

      The result of the policy evaluation for this connection.

      • 'approved': Policy evaluation passed and the operation was allowed
      • 'rejected': Policy evaluation failed and the operation was denied Not present if no policy evaluation was performed or if evaluation is still pending.
      approvedrejected
    • partnersConnectionId string nullable required
      The partner's identifier for this connection. This is the identifier used by the partner in their system to refer to this connection. Will be null if the connection hasn't been initialized by the partner.

      at least 1 characters

    • partnersClientId string nullable required
      The partner's identifier for the client. This is the identifier used by the partner in their system to refer to the client. Will be null if the connection hasn't been initialized by the partner.

      at least 1 characters

    • initialized boolean required
      Indicates whether the connection has been initialized by the partner. When true, the partner has established this connection on their side. When false, the connection is pending initialization by the partner.
400
Bad Request
No response body
401
Unauthorized

Response Body

object

  • error string required
403
Forbidden

Response Body

object

  • error string required
404
Not Found

Response Body

object

  • error string required
500
Internal Server Error

Response Body

object

  • error string required