# Get payments by instruction

Returns the list of individual payments linked to an instruction identified by instruction_id under the given client_id.
Each payment record includes its id, destination account, amount, optional clientRef, current status (such as new or completed), and any explanatory reason or reasonCode. Use this endpoint to monitor execution and settlement of all payments created within a given payment instruction.

Endpoint: GET /v2/partner/client/{client_id}/instruction/{instruction_id}/payment
Version: 2.0.0
Security: oAuth

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `instruction_id` (string, required)
    The ID of requested instruction.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Response 200 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `sortedId` (string)
    Sortable ID for ordering payments chronologically

  - `account` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `amount` (number)
    Payment amount

  - `clientRef` (string)
    Client applied ref
    Example: "my_order_123"

  - `status` (string)
    Payment status

  - `reason` (string,null)
    Reason of failure

  - `reasonCode` (string,null)
    Bankgiro error code

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error