---
title: "Retrieve a Payment"
method: GET
path: "/payments/payment/{id}"
tags: ["payments"]
---

# Retrieve a Payment

`GET /payments/payment/{id}`

Retrieve a single payment by ID.

## Path parameters

- `id` string, required

## Query parameters

- `expand` string

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successfully retrieved

- PaymentsGetPaymentsPaymentIdResponse200
  - `id` string — The unique identifier of the payment.
  - `payment_method` string — The method used to send this payment (e.g. ACH, check).
  - `status` string — The human-readable status of the payment.
  - `status_code` integer — The numeric status code of the payment.
  - `last_error` string — The last error message encountered during payment processing, if any.
  - `erp_vendor_id` string — The vendor's unique identifier in your ERP system.
  - `ottimate_company_id` integer — The Ottimate company ID associated with this payment.
  - `customer_account_number` string — Your account number with the vendor.
  - `scheduled_date` string — The ISO 8601 date and time when the payment is scheduled to be sent.
  - `memo` string — The memo or note included with the payment.
  - `payment_number` string — Your internal identifier for this payment.
  - `expected_delivery_date` string — The expected date the payment will be delivered to the vendor.
  - `invoices` PaymentsPaymentIdGetResponsesContentApplicationJsonSchemaInvoicesItems[] — Returned only when expanded via the 'expand' query parameter
    - `id` integer — The unique identifier of the invoice.
    - `invoice_number` string — The invoice number as it appears in your system.
    - `date` string — The invoice date in YYYY-MM-DD format.
    - `total_amount` string — The total amount of the invoice.
    - `currency` string — The ISO 4217 currency code for the invoice amount.
    - `notes` string — Additional notes on the invoice.

## Other responses

- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found - Resource does not exist

## Changes

> 11 revisions in range; 2 could not be searched.

- **2026-08-19** `c0b5cf6c7a72` — 1 info
  - added the non-success response with the status `403`
- **2026-08-17** `c231509a03cf` — 1 breaking, 2 info
  - the `message` response's property type/format changed from `string`/`` to ``/`` for status `404`
  - the response property `code` became required for the status `404`
  - the response property `message` became required for the status `404`
- **2026-08-13** `1f089f3e34d9` — 3 breaking
  - the response property `code` became optional for the status `404`
  - the response property `message` became optional for the status `404`
  - the `message` response's property type/format changed from ``/`` to `string`/`` for status `404`

[Change history](https://skmtc.dev/ottimate/apis/api-reference/changes/payments/payment/:id/get.md)

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)