# Get bulk-payment information

Endpoint: GET /bulk-payments/{paymentProduct}/{paymentId}
Version: 1.0.0
Security: Api access

## Path parameters:

  - `paymentProduct` (string, required)
    Enum: "creditTransfer", "directDebit"

  - `paymentId` (string, required)
    Id of the payment initiation

## Query parameters:

  - `cursor` (string)
    A reference to a specific page

## Header parameters:

  - `PSU-IP-Address` (string)
    IP Address of the PSU.

  - `Consent-ID` (string)
    The consent id. Should be set unless a specific Subscription-Id is used.

  - `Channel-Type` (string)
    The banking channel.
    Enum: "unspecified", "openBanking", "psd2"

  - `Subscription-Id` (string)
    Id of the subscription to use. Only supported for Channel-Type openBanking.

  - `Resource-Group-Name` (string)
    Name of the resource group to use in the specified subscription. Only supported for Channel-Type openBanking

  - `Scopes` (array)
    Resource scopes to use, mutually exclusive with subscriptionId.
- /: Use all resources available.
- /subscriptions/7fdf00601dfb: Use all resources in subscription 7fdf00601dfb.
- /subscriptions/7fdf00601dfb/resource-groups/my-company: Use all resources within subscription 7fdf00601dfb and resource-group my-company.
    Example: "/subscriptions/7fdf00601dfb/resource-groups/my-company"

  - `api-version` (string)

## Response 200 fields (application/json):

  - `paymentId` (string)
    Id of the payment initiation
    Example: "A30D7108-A584-4C32-95ED-8FF4BB5A7C2C"

  - `transactionStatus` (string)
    Status of the payment
    Enum: "accc", "accp", "acsc", "acsp", "actc", "acwc", "acwp", "rcvd", "pdng", "rjct", "canc", "acfc", "patc", "part"

  - `tppMessage` (array)
    Messages on operational issues.

  - `tppMessage.category` (string, required)
    TPP message category.
    Enum: "error", "warning"

  - `tppMessage.code` (string, required)
    Code of the TPP message.
    Example: "AC03"

  - `tppMessage.message` (null,string)
    Additional explaining text.

  - `requestedExecutionDate` (null,string)

  - `debtorAccount` (object)
    Account reference

  - `debtorAccount.iban` (null,string)
    IBAN of the account
    Example: "FR7612345987650123456789014"

  - `debtorAccount.bban` (null,string)
    BBAN of the account - ISO 20022
    Example: "BARC12345612345678"

  - `debtorAccount.other` (null)
    Generic account reference.

  - `debtorAccount.currency` (null,string)
    Currency code - ISO 4217
    Example: "EUR"

  - `debtorAccount.pan` (null,string)
    Primary Account Number - ISO/IEC 7812
    Example: 5409050000000000

  - `debtorAccount.maskedPan` (null,string)
    Masked Primary Account Number - ISO/IEC 7812
    Example: "123456xxxxxx1234"

  - `debtorAccount.msisdn` (null,string)
    Mobile phone number
    Example: "+491701234567"

  - `debtorName` (null,string)
    Debtor name

  - `debtorAddress` (null)
    Debtor address

  - `createdAt` (null,string)

  - `updatedAt` (null,string)

  - `_links` (object)

  - `_links.self` (object)

  - `_links.self.href` (string)
    Url to a resource
    Example: "https://banking.aritma.io/api/accounts/1234/transactions?fromDate=2019-08-24T14:15:22Z"

  - `_links.self.verb` (string)
    The http verb the link is accessible through
    Enum: "get", "post", "put", "delete"

  - `_links.status` (object)

  - `_links.startAuthorization` (null)

  - `_links.scaRedirect` (null)

  - `_links.next` (null)

  - `_links.prev` (null)

  - `batchBookingPreferred` (boolean)

  - `payments` (array)

  - `payments.endToEndIdentification` (null,string)
    End to end identification

  - `payments.instructedAmount` (object, required)
    Instructed amount

  - `payments.instructedAmount.currency` (null,string)
    The three-letter currency code of the amount - ISO 4217
    Example: "NOK"

  - `payments.instructedAmount.amount` (null,string)
    The amount value. Negative amounts are signed by minus. The decimal separator is a dot.
            
Example:
* 0
* 154
* -1.75
* 349.7
* 3632.78
    Example: 3632.78

  - `payments.creditorAccount` (object, required)
    Creditor account

  - `payments.creditorAgent` (null,string)
    BICFI
    Example: "DNBANOKK"

  - `payments.creditorAgentCountryCode` (null,string)
    Country code of the creditor agent.
    Example: "NO"

  - `payments.creditorAgentClearingSystem` (null)
    Information about a clearing system member, which might be required for payments to non EEA member states.

  - `payments.creditorName` (string, required)
    Creditor name
    Example: "Ola"

  - `payments.creditorAddress` (null)
    Creditor address

  - `payments.remittanceInformationUnstructured` (null,string)
    Unstructured remittance information
    Example: "message"

  - `payments.remittanceInformationStructured` (null)
    Structured remittance information

  - `payments.remittanceInformationStructuredArray` (null,array)

  - `payments.remittanceInformationStructuredArray.reference` (null,string)
    Reference
    Example: 777588823

  - `payments.remittanceInformationStructuredArray.referenceType` (null,string)
    Reference type
    Example: "SCOR"

  - `payments.remittanceInformationStructuredArray.referenceIssuer` (null,string)

  - `payments.purposeCode` (null,string)
    External purpose code (ExternalPurpose1Code from ISO 20022)
            
Example:
* SUPP: Payment to a supplier.
* SALA: Payment of salaries.
* IPAY: Instant payment.
* INTC: Intra-company payment.
* TAXS: Payment of taxes.
* PENS: Payment of pension.
* TREA: Treasury operations.
* CORT: Settlement of a trade, e.g. a foreign exchange deal or a securities transaction.

An example usage of this field is for salary payments. They would typically use the purpose code "SALA".

  - `payments.purposeProprietary` (null,string)
    Purpose in a proprietary form.

  - `payments.categoryPurposeCode` (null,string)
    External category purpose code (ExternalCategoryPurpose1Code from ISO 20022)

Supported values are: [
BONU, CASH, CBLK, CCRD, CORT, DCRD, DIVI, DVPM, EPAY, FCIN, FCOL,
GP2P, GOVT, HEDG, ICCP, IDCP, INTC, INTE, LBOX, LOAN, MP2B, MP2P,
OTHR, PENS, RPRE, RRCT, RVPM, SALA, SECU, SSBE, SUPP, TAXS, TRAD,
TREA, VATX, WHLD, SWEP, TOPG, ZABA, VOST, FCDT, CIPC, CONC, CGWV,
SAVG, CTDF
]
An example usage of this field is for salary payments. They would typically use the purpose code "SALA".

  - `payments.regulatoryReportingAmount` (null)
    Amount with currency

  - `payments.regulatoryReportingCode` (null,string)
    Regulatory reporting code
    Example: 26

  - `payments.regulatoryReportingInformation` (null,string)
    Regulatory reporting info
    Example: "Rent"

  - `payments.bundleReference` (null,string)
    Reference that can be used for choosing what payments will be bundled together
    Example: "bundle-id-123456789"

  - `payments.instructionPriority` (null)

  - `payments.paymentId` (null,string)
    Unique payment identification

  - `payments.transactionStatus` (null)
    Status of the payment line
    Example: "pdng"

## Response 401 fields (application/json):

  - `type` (null,string)

  - `title` (null,string)

  - `status` (null,integer)

  - `detail` (null,string)

  - `instance` (null,string)

## Response 403 fields (application/json):

  - `type` (null,string)

  - `title` (null,string)

  - `status` (null,integer)

  - `detail` (null,string)

  - `instance` (null,string)

## Response 404 fields (application/json):

  - `type` (null,string)

  - `title` (null,string)

  - `status` (null,integer)

  - `detail` (null,string)

  - `instance` (null,string)