Skip to main content
GET
/
v1
/
counterparty
/
{id}
Get counterparty
curl --request GET \
  --url http://localhost:3001/v1/counterparty/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "name": "<string>",
  "markedTrusted": true,
  "markedTrustedDate": "2023-11-07T05:31:56Z",
  "markedTrustedUser": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "name": "<string>",
    "authId": "<string>",
    "role": "<string>",
    "hasPushNotification": true,
    "organization": {
      "id": "<any>",
      "createdAt": "<any>",
      "updatedAt": "<any>",
      "name": "<any>",
      "slug": "<any>",
      "logoFileName": "<any>",
      "country": "<any>",
      "vatNumber": "<any>",
      "featureFlags": "<any>"
    }
  },
  "description": "<string>",
  "vat": "<string>",
  "accountsPayableNumber": "22 0391919",
  "street": "<string>",
  "city": "<string>",
  "zip": "<string>",
  "country": "<string>",
  "paymentTermsDays": 123,
  "skontoPercentage": 123,
  "skontoDays": 123,
  "organization": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "slug": "<string>",
    "logoFileName": "<string>",
    "country": "<string>",
    "vatNumber": "<string>",
    "featureFlags": [
      "<any>"
    ]
  },
  "bankAccount": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "iban": "<string>",
    "bic": "<string>",
    "countryCode": "<string>",
    "address": "<string>"
  },
  "bankAccountVerification": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "bankAccount": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>"
    },
    "paymentProvider": "<string>",
    "status": "VALID",
    "initializedAt": "2023-11-07T05:31:56Z",
    "mailTrackings": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "version": 123,
      "type": "ONBOARDING",
      "status": "ACCEPTED"
    },
    "fullName": "<string>"
  },
  "transactions": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "amount": 123,
    "remittanceInformation": "<string>",
    "requestedExecutionDate": "2023-11-07T05:31:56Z",
    "skontoAmount": 123,
    "skontoDate": "2023-11-07T05:31:56Z",
    "ignoreSkontoDeadline": true,
    "creditor": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>"
    },
    "debitor": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>"
    },
    "analysis": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "analysisRules": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "type": "AMOUNT_DEVIATION",
        "severity": "NORMAL",
        "markedOk": true,
        "markedOkReason": "<string>",
        "markedOkDate": "2023-11-07T05:31:56Z",
        "value": "<string>",
        "markedOkUser": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true,
          "organization": {
            "id": "<any>",
            "createdAt": "<any>",
            "updatedAt": "<any>",
            "name": "<any>",
            "slug": "<any>",
            "logoFileName": "<any>",
            "country": "<any>",
            "vatNumber": "<any>",
            "featureFlags": "<any>"
          }
        }
      },
      "customRules": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "description": "<string>",
        "rule": "<string>",
        "twoFactorCheck": true,
        "accountCheck": true,
        "deleted": true,
        "active": true,
        "organization": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "name": "<string>",
          "slug": "<string>",
          "logoFileName": "<string>",
          "country": "<string>",
          "vatNumber": "<string>",
          "featureFlags": [
            "<any>"
          ]
        }
      }
    },
    "archived": true,
    "archivedDate": "2023-11-07T05:31:56Z",
    "archivedByUser": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "email": "<string>",
      "name": "<string>",
      "authId": "<string>",
      "role": "<string>",
      "hasPushNotification": true,
      "organization": {
        "id": "<any>",
        "createdAt": "<any>",
        "updatedAt": "<any>",
        "name": "<any>",
        "slug": "<any>",
        "logoFileName": "<any>",
        "country": "<any>",
        "vatNumber": "<any>",
        "featureFlags": "<any>"
      }
    },
    "paymentRun": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "createdByName": "<string>",
      "organizationId": "<string>",
      "sumAmount": 123,
      "sumAmountWithSkonto": 123,
      "sumBookedAmount": 123,
      "transactionCount": 123
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Counterparty ID

Response

200 - application/json
​
email
string
required

The email of the counterparty.

​
name
string
required

The name of the counterparty.

​
markedTrusted
boolean
required

Determines if the counterparty has been marked as trusted.

​
markedTrustedDate
string<date-time>
required

The date and time the counterparty was marked as trusted.

​
markedTrustedUser
object
required

The user that marked the counterparty as trusted.

​
description
string
required

The description of the counterparty.

​
vat
string
required

The EU VAT number of the counterparty.

​
accountsPayableNumber
string
required

Accounts payable number of the counterparty. Used in bookkeeping.

Example:

"22 0391919"

​
street
string
required

Street name and number of the counterparty.

​
city
string
required

City of the counterparty.

​
zip
string
required

ZIP or postal code of the counterparty.

​
country
string
required

Country of the counterparty using ISO 3166-1 alpha-2 code.

​
paymentTermsDays
number
required

Payment term in days

​
skontoPercentage
number
required

Early payment discount percentage

​
skontoDays
number
required

Days for early payment discount

​
organization
object
required

The organization of the counterparty.

​
bankAccount
object
required

The bank account of the counterparty.

​
bankAccountVerification
object
required

The verification of the counterpartys bank account.

​
transactions
object
required

The transactions of the counterparty.

​
id
string

The unique identifier of the entity.

​
createdAt
string<date-time>

The date and time the entity was created.

​
updatedAt
string<date-time>

The date and time the entity was last updated.