---
title: "Retrieve All Creditor Registrations"
method: GET
path: "/creditor-agents/{ica}/creditors"
tags: ["CreditorRegistration"]
---

# Retrieve All Creditor Registrations

`GET /creditor-agents/{ica}/creditors`

## Request

- Base URL: `https://api.mastercard.com/commercial/payments`
- URL: `https://api.mastercard.com/commercial/payments/creditor-agents/{ica}/creditors`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mastercard/apis/payment-acceptance-api/docs/creditor-agents/:ica/creditors/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to retrieve all existing Creditors.

## Path parameters

- `ica` string, required

## Query parameters

- `legal_business_name` string
- `dba` string
- `creditor_profile_id` string
- `is_active` boolean
- `offset` integer
- `limit` integer
- `sort` 'ORGANISATION_NAME' | 'ADDRESS_LINE' | 'TOWN_NAME' | 'COUNTRY_SUB_DIVISION' | 'POST_CODE' | 'COUNTRY_CODE' | 'ORGANISATION_IDENTIFICATION' | 'PROFILE_COUNT'

## Response `200`

List of Creditor Search result.

- CreditorSearchResults
  - `data` object
    - `count` integer: Number of results returned.
    - `items` CreditorSearchResultItem[]: Results filtered
      - `dba` string: Doing Business As
      - `id` string: A unique identifier for the Creditor's Company generated by a system (UUID).
      - `inactiveReason` string: Identifies the reason why the business is not active in CDP. Valid Values 'PRE_REGISTERED', 'AGENT_HOLD'
      - `isActive` boolean: Indicates if the business is active in CDP.
      - `legalBusinessAddress` CreditorLegalAddress: Identifies the legal business address of the Creditor receiving the payment.
        - `addressLine` string, required: Identifies the street address of the business.
        - `country` string, required: Identifies the country where the business is located.
        - `countrySubDivision` string: Identifies the subdivision within a country where the business is located such as the state, region, or county.
        - `postCode` string: Identifies the mailing or zip code for the business.
        - `townName` string: Identifies the name of the city or geographical location of the business.
      - `legalBusinessName` string: Identifies the legal business name of the Creditor receiving the payment.
      - `organisationIdentifications` OrganisationIdentification[]: A unique and unambiguous way to identify an organisation.
        - `identification` string, required: A unique identification for the organisation.
        - `type` string, required: Organisation Identification Type
      - `profileCount` integer: Number of profiles that match the search.
    - `limit` integer: Maximum results returned from a search query.
    - `offset` integer: The starting row of results started at.
    - `total` integer: Total number of results available to be returned.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Access Denied

---

[API](https://skmtc.dev/mastercard/apis/payment-acceptance-api.md) - [All operations](https://skmtc.dev/mastercard/apis/payment-acceptance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mastercard/apis/payment-acceptance-api/revisions/baa0a0739572?raw)