# Returns the outbound payment with the given identifier.

`GET /accounting/outbound-payments/{id}`

Group: Accounting › Outbound Payments · Operation ID: `getOutboundPayment`

An outbound payment is money paid out to a vendor or employee, with one or more lines. It shares its read with POST accounting/outbound-payments/search, which returns the same record. The list at GET accounting/outbound-payments is header-only, so the payment lines come back here and on search. Each line's payee bank account and sort code are returned here and on search but never on the list and never filterable.

[Open in the interactive reference](https://docs.api.lensing.ai/?op=getOutboundPayment)

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Api-Version` | header | `"v1"` | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version `v1`. |
| `id` | path | string | yes | The unique identifier for the outbound payment to return. |

## Response

`200` Success

Under `data` (getOutboundPaymentOutput):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | The unique identifier for the outbound payment. |
| `outboundPaymentNumber` | string | no | The outbound payment number. Absent until a number has been assigned. |
| `description` | string | no | A description of the payment. |
| `paymentDate` | string (date) | yes | The date the payment was made. Format YYYY-MM-DD. |
| `paymentCurrency` | string | yes | The currency the payment is denominated in. Format ISO 4217, for example 'USD'. Governs totalPaid, appliedAmount and unappliedAmount. |
| `paymentType` | string | yes | How the money was sent, for example 'ach', 'wire' or 'check'. |
| `status` | string | yes | The processing status of the payment. |
| `approvalStatus` | string | no | Where the payment sits in the approval workflow. |
| `applicationStatus` | string | no | How much of the payment has been applied to bills. Values include 'unapplied', 'partiallyApplied' and 'applied'. |
| `totalPaid` | string (decimal) | no | The total amount paid, in the payment currency. |
| `appliedAmount` | string (decimal) | no | The portion already applied against vendor bills, in the payment currency. |
| `unappliedAmount` | string (decimal) | no | The portion not yet applied to any bill, in the payment currency. |
| `bankCurrency` | string | no | The currency of the bank account the money left, when it differs from the payment currency. Format ISO 4217, for example 'USD'. |
| `paymentId` | string | no | The payment reference assigned by the bank or payment provider. |
| `externalId` | string | no | The identifier this payment has in the upstream system that produced it. It is not unique. |
| `externalUrl` | string | no | A link to the payment in an external system, when one is stored. |
| `origin` | string | no | The source system this payment came from. Recorded when an integration created the payment. |
| `singlePayment` | boolean | no | Whether the payment covers a single bill rather than a batch. |
| `paymentAccountId` | string | no | The bank GL account the money left. See id on GET accounting/accounts/:id. |
| `paymentAccountName` | string | no | The name of the bank GL account the money left. |
| `entityId` | string | no | The legal entity that made the payment. See id on GET base/entities. |
| `entityName` | string | no | The name of the legal entity that made the payment. |
| `lastModifiedDate` | string (date-time) | yes | The date and time the payment last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. |
| `lines` | array of object | no | The payment lines, one per payee or bill covered. An empty array when the payment has none. |
| `lines[].id` | string | yes | The unique identifier for the line. |
| `lines[].lineNumber` | string | no | The line number. |
| `lines[].description` | string | yes | A description of the line. |
| `lines[].amount` | string (decimal) | no | The amount paid on this line, in the line currency. |
| `lines[].currency` | string | yes | The currency for the line. Format ISO 4217, for example 'USD'. |
| `lines[].paymentDate` | string (date) | no | The date this line was paid, when it differs from the header. Format YYYY-MM-DD. |
| `lines[].paymentType` | string | no | How this line was sent, for example 'ach', 'wire' or 'check'. |
| `lines[].receiverName` | string | yes | The name of the payee. |
| `lines[].receiverAccount` | string | no | The payee bank account number. It is returned here and on search but never on the collection endpoint and never filterable. |
| `lines[].receiverBankCode` | string | no | The payee sort or routing code. It is returned here and on search but never on the collection endpoint and never filterable. |
| `lines[].customReference` | string | no | A reference you supplied, carried on the line. |

## Errors

| Code | Status |
| --- | --- |
| `NOT_FOUND` | 400 |

## Statuses

- `400` — Invalid request or business failure. Codes: NOT_FOUND
- `401` — Missing or invalid access token
- `403` — Not authorized
- `404` — Not found
- `429` — Too many requests
- `500` — Internal server error