Get counterparty by ID

Demo

https://api.demo.getneo.com

GET

/v3/counterparties/{id}

Gets a single active counterparty by ID.
If the counterparty has never been active, the draft will be returned.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.demo.getneo.com/v3/counterparties/' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "accounts": [
        {
            "accountNumber": "string",
            "actions": [
                "string"
            ],
            "additionalCountryAccountInfo": "string",
            "alias": "string",
            "bank": "string",
            "bankAccountId": "abcdefghijkl0123456789",
            "bankCode": "string",
            "bic_swift": "NEOPESBB",
            "country": "ESP",
            "currencies": [
                "EUR"
            ],
            "iban": "string",
            "intermediaryBank": "string",
            "intermediaryBankAccounts": [
                {
                    "currency": "EUR",
                    "bicSwift": "NEOPESBB"
                }
            ],
            "isBeneficiary": true,
            "isPayer": true,
            "operatorInfo": "string",
            "parentId": "abcdefghijkl0123456789",
            "recurringReference": "string",
            "routingNumber": "string",
            "sortCodeUK": "string"
        }
    ],
    "actions": [
        "string"
    ],
    "address1": "string",
    "address2": "string",
    "alias": "string",
    "city": "string",
    "country": "ESP",
    "county": "string",
    "currencies": [
        "EUR"
    ],
    "draft": {},
    "email": "string",
    "firstName": "string",
    "id": "abcdefghijkl0123456789",
    "isBeneficiary": true,
    "isPayer": true,
    "isSelf": true,
    "lastName": "string",
    "linkedDocuments": {
        "count": 0,
        "uri": "http://example.com"
    },
    "name": "string",
    "paymentReason": [
        "string"
    ],
    "postCode": "string",
    "primaryType": "string",
    "shortfall": 0,
    "shortfallCurrencyCode": "EUR",
    "state": "draft",
    "subsidiary": "string",
    "subType": "string",
    "thirdPartyType": "string",
    "thirdPartyTypeOther": "string",
    "vanityId": "string"
}

Modified at 2025-11-28 09:18:21

Get all counterparties

Get draft counterparty by ID