List Settlement Disputes for a Client

get/api/network/v1/enterprises/{enterpriseId}/clients/settlement/disputes

This API call allows clients to list disputes associated with their settlements.

Path Parameters

  • enterpriseIdstringRequired
    The enterprise identifier of the client. This identifies the client enterprise that owns the allocation.
    Min length: >= 1 characters

Query Parameters

  • settlementIdsarray[string]
    Optional array of settlement ids. If provided will only return disputes with a disputedSettlementId matching one of the provided settlementIds.
  • settledInSettlementIdsarray[string]
    Optional array of settlement ids. If provided will only return disputes with a settledInSettlementId matching one of the provided settlementIds.
  • connectionIdsarray[string]
    Optional array of connection ids. If provided will only return disputes with a connectionId matching one of the provided connectionIds.
  • partnerIdsarray[string]
    Optional array of partner ids. If provided will only return disputes for settlements initiated by a partner with an id matching one of the provided partnerIds.
  • closedboolean
    Optional boolean value indicating whether to include only closed/open disputes in the response. If true is provided, only closed disputes will be returned. If false is provided, only open disputes will be returned. If not provided, all disputes will be returned.
  • disputeIdsarray[string]
    Optional array of disputeIds. If provided will only return disputes with an id matching one of the provided disputeIds.
  • disputeClosureIdsarray[string]
    Optional array of disputeClosureIds. If provided will only return disputes with a disputeClosureId matching one of the provided disputeClosureIds.
  • pageNumberstring<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.
  • pageSizestring
    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.

200 Response

disputes array[object] required
disputeClosure object
id string required
createdAt string <date-time>required
updatedAt string <date-time>required
connectionId string required
disputedSettlementId string required
userId string required
Min length: >= 1 characters
expectedTransfers dictionary<string, string> required
retracted boolean required
settledInSettlementId string
reason string
Min length: >= 1 characters
retractedBy string
Min length: >= 1 characters
retractedAt string <date-time>
disputeClosureId string
retractedReason string
Min length: >= 1 characters

400 Response

401 Response

error string required

403 Response

error string required

404 Response

error string required

409 Response

error string required

422 Response

error string required

500 Response

error string required