Skip to main content
GET
/
v1
/
counterparty
/
{id}
Get counterparty
curl --request GET \
  --url http://localhost:3001/v1/counterparty/{id} \
  --header 'Authorization: Bearer <token>'
{
  "email": "<string>",
  "name": "<string>",
  "markedTrusted": true,
  "markedTrustedDate": "2023-11-07T05:31:56Z",
  "markedTrustedUser": {
    "email": "<string>",
    "name": "<string>",
    "authId": "<string>",
    "role": "<string>",
    "hasPushNotification": true,
    "organization": {
      "name": "<string>",
      "slug": "<string>",
      "logoFileName": "<string>",
      "country": "<string>",
      "vatNumber": "<string>",
      "featureFlags": [
        {
          "featureName": "<string>",
          "isEnabled": true,
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        }
      ],
      "baseCurrency": "EUR",
      "paymentRunBatchBooking": true,
      "paymentRunVerificationOfPayee": true,
      "invoiceExportIncludeForeignCurrencies": true,
      "allowDirectInvoiceApproval": true,
      "allowDirectPaymentRunApproval": true,
      "customExportFormats": [
        "custom_experta"
      ],
      "autoPopulateCustomerEmailFromMetadata": true,
      "autoPopulateSupplierEmailFromMetadata": true,
      "excludedEmailDomains": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "inCaseOfLawCustomerId": "<string>",
      "cardCommonBookingTargetName": "<string>",
      "cardCommonBookingTargetAccountsPayableNumber": "<string>",
      "cardFxDifferenceLedgerAccount": "<string>"
    },
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "featureFlags": [
      "invoice"
    ]
  },
  "description": "<string>",
  "vat": "<string>",
  "accountsPayableNumber": "22 0391919",
  "accountsPayableMode": "AUTO",
  "street": "<string>",
  "city": "<string>",
  "zip": "<string>",
  "country": "<string>",
  "paymentTermsDays": 123,
  "skontoPercentage": 123,
  "skontoDays": 123,
  "organization": {
    "name": "<string>",
    "slug": "<string>",
    "logoFileName": "<string>",
    "country": "<string>",
    "vatNumber": "<string>",
    "featureFlags": [
      {
        "featureName": "<string>",
        "isEnabled": true,
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    ],
    "baseCurrency": "EUR",
    "paymentRunBatchBooking": true,
    "paymentRunVerificationOfPayee": true,
    "invoiceExportIncludeForeignCurrencies": true,
    "allowDirectInvoiceApproval": true,
    "allowDirectPaymentRunApproval": true,
    "customExportFormats": [
      "custom_experta"
    ],
    "autoPopulateCustomerEmailFromMetadata": true,
    "autoPopulateSupplierEmailFromMetadata": true,
    "excludedEmailDomains": "<string>",
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "inCaseOfLawCustomerId": "<string>",
    "cardCommonBookingTargetName": "<string>",
    "cardCommonBookingTargetAccountsPayableNumber": "<string>",
    "cardFxDifferenceLedgerAccount": "<string>"
  },
  "bankAccount": {
    "name": "<string>",
    "iban": "<string>",
    "bic": "<string>",
    "countryCode": "<string>",
    "address": "<string>",
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "bankAccountVerification": {
    "bankAccount": {
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "paymentProvider": "<string>",
    "status": "VALID",
    "initializedAt": "2023-11-07T05:31:56Z",
    "mailTrackings": {
      "version": 123,
      "type": "ONBOARDING",
      "status": "ACCEPTED",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "fullName": "<string>",
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "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,
    "express": true,
    "currency": "EUR",
    "creditor": {
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "debitor": {
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "analysis": {
      "analysisRules": {
        "type": "AMOUNT_DEVIATION",
        "severity": "NORMAL",
        "markedOk": true,
        "markedOkReason": "<string>",
        "markedOkDate": "2023-11-07T05:31:56Z",
        "value": "<string>",
        "markedOkUser": {
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true,
          "organization": {
            "name": "<string>",
            "slug": "<string>",
            "logoFileName": "<string>",
            "country": "<string>",
            "vatNumber": "<string>",
            "featureFlags": [
              {
                "featureName": "<string>",
                "isEnabled": true,
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z"
              }
            ],
            "baseCurrency": "EUR",
            "paymentRunBatchBooking": true,
            "paymentRunVerificationOfPayee": true,
            "invoiceExportIncludeForeignCurrencies": true,
            "allowDirectInvoiceApproval": true,
            "allowDirectPaymentRunApproval": true,
            "customExportFormats": [
              "custom_experta"
            ],
            "autoPopulateCustomerEmailFromMetadata": true,
            "autoPopulateSupplierEmailFromMetadata": true,
            "excludedEmailDomains": "<string>",
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "inCaseOfLawCustomerId": "<string>",
            "cardCommonBookingTargetName": "<string>",
            "cardCommonBookingTargetAccountsPayableNumber": "<string>",
            "cardFxDifferenceLedgerAccount": "<string>"
          },
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "featureFlags": [
            "invoice"
          ]
        },
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "customRules": {
        "name": "<string>",
        "description": "<string>",
        "rule": "<string>",
        "twoFactorCheck": true,
        "accountCheck": true,
        "deleted": true,
        "active": true,
        "organization": {
          "name": "<string>",
          "slug": "<string>",
          "logoFileName": "<string>",
          "country": "<string>",
          "vatNumber": "<string>",
          "featureFlags": [
            {
              "featureName": "<string>",
              "isEnabled": true,
              "id": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z"
            }
          ],
          "baseCurrency": "EUR",
          "paymentRunBatchBooking": true,
          "paymentRunVerificationOfPayee": true,
          "invoiceExportIncludeForeignCurrencies": true,
          "allowDirectInvoiceApproval": true,
          "allowDirectPaymentRunApproval": true,
          "customExportFormats": [
            "custom_experta"
          ],
          "autoPopulateCustomerEmailFromMetadata": true,
          "autoPopulateSupplierEmailFromMetadata": true,
          "excludedEmailDomains": "<string>",
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "inCaseOfLawCustomerId": "<string>",
          "cardCommonBookingTargetName": "<string>",
          "cardCommonBookingTargetAccountsPayableNumber": "<string>",
          "cardFxDifferenceLedgerAccount": "<string>"
        },
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "archived": true,
    "archivedDate": "2023-11-07T05:31:56Z",
    "archivedByUser": {
      "email": "<string>",
      "name": "<string>",
      "authId": "<string>",
      "role": "<string>",
      "hasPushNotification": true,
      "organization": {
        "name": "<string>",
        "slug": "<string>",
        "logoFileName": "<string>",
        "country": "<string>",
        "vatNumber": "<string>",
        "featureFlags": [
          {
            "featureName": "<string>",
            "isEnabled": true,
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "baseCurrency": "EUR",
        "paymentRunBatchBooking": true,
        "paymentRunVerificationOfPayee": true,
        "invoiceExportIncludeForeignCurrencies": true,
        "allowDirectInvoiceApproval": true,
        "allowDirectPaymentRunApproval": true,
        "customExportFormats": [
          "custom_experta"
        ],
        "autoPopulateCustomerEmailFromMetadata": true,
        "autoPopulateSupplierEmailFromMetadata": true,
        "excludedEmailDomains": "<string>",
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "inCaseOfLawCustomerId": "<string>",
        "cardCommonBookingTargetName": "<string>",
        "cardCommonBookingTargetAccountsPayableNumber": "<string>",
        "cardFxDifferenceLedgerAccount": "<string>"
      },
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "featureFlags": [
        "invoice"
      ]
    },
    "paymentRun": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "createdByName": "<string>",
      "organizationId": "<string>",
      "sumAmount": 123,
      "sumAmountWithSkonto": 123,
      "sumBookedAmount": 123,
      "transactionCount": 123,
      "batchBooking": true
    },
    "counterparty": "<unknown>",
    "invoice": {
      "id": "<string>",
      "invoiceNumber": "<string>",
      "status": "<string>",
      "totalAmount": 123,
      "dueDate": "2023-11-07T05:31:56Z",
      "invoiceDate": "2023-11-07T05:31:56Z",
      "currency": "<string>"
    }
  },
  "cardBookingPreference": "INVOICE_COUNTERPARTY",
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "apBalance": {
    "openInvoiceAmount": 123,
    "approvedOpenCreditNoteAmount": 123,
    "manualCreditAmount": 123,
    "totalAvailableCredit": 123,
    "netPayableAmount": 123,
    "remainingCreditBalance": 123,
    "scheduledBankTransferAmount": 123,
    "remainingToScheduleAmount": 123,
    "unapprovedCreditNoteAmount": 123,
    "appliedInvoiceCreditAmount": 123,
    "balancesByCurrency": [
      {
        "currency": "EUR",
        "approvedOpenCreditNoteAmount": 123,
        "manualCreditAmount": 123,
        "totalAvailableCredit": 123,
        "appliedInvoiceCreditAmount": 123,
        "remainingCreditBalance": 123
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ibana.io/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
accountsPayableMode
enum<string>
required

How accounts payable number is managed for this counterparty.

Available options:
AUTO,
MANUAL,
NONE
​
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.

​
cardBookingPreference
enum<string>
required

Default booking preference for card-paid invoices of this counterparty.

Available options:
INVOICE_COUNTERPARTY,
ORG_CARD_COMMON
​
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.

​
apBalance
object

Derived AP balance for this counterparty.