> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iterapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get payment address and info for an invoice

> Retrieve the blockchain payment address, expected amount, and expiry for a specific invoice and payment method.

These public endpoints return the payment details a customer needs to complete an invoice payment — specifically the deposit address, the exact amount to send, and when the payment window expires. No authentication is required, making these endpoints suitable for customer-facing checkout flows.

Two variants are available: one to fetch the address for a single payment method, and one to retrieve addresses across all payment methods associated with the invoice.

***

## Get address for a specific payment method

**`GET /public/invoices/{invoiceID}/method/{methodID}/address`**

Returns the deposit address and payment details for a single payment method on an invoice.

### Path parameters

<ParamField path="invoiceID" type="string" required>
  The UUID of the invoice.
</ParamField>

<ParamField path="methodID" type="number" required>
  The integer ID of the payment method to retrieve an address for.
</ParamField>

### Response

<ResponseField name="address" type="string" required>
  The blockchain address the customer should send funds to.
</ResponseField>

<ResponseField name="amount" type="string" required>
  The exact amount the customer must send, expressed as a decimal string with up to 6 decimal places.
</ResponseField>

<ResponseField name="expiresAt" type="string" required>
  ISO 8601 timestamp indicating when the payment address expires. Payments received after this time may not be credited.
</ResponseField>

***

## Get all addresses for an invoice

**`GET /public/invoices/{invoiceID}/addresses`**

Returns an array of address objects across all payment methods configured for the invoice.

<Info>
  Although this endpoint is under the `/public/` path, it requires authentication via Bearer token or API key.
</Info>

### Path parameters

<ParamField path="invoiceID" type="string" required>
  The UUID of the invoice to retrieve addresses for.
</ParamField>

### Response

Returns an array of address objects, one per supported payment method.

<ResponseField name="data" type="object[]">
  Array of payment address objects.

  <Expandable title="address properties">
    <ResponseField name="address" type="string">
      The blockchain address for this payment method.
    </ResponseField>

    <ResponseField name="amount" type="string">
      The exact amount to send for this payment method.
    </ResponseField>

    <ResponseField name="expiresAt" type="string">
      ISO 8601 expiry timestamp for this address.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Single method address (no auth) theme={null}
  curl --request GET \
    --url https://api.iterapay.com/public/invoices/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f/method/1/address
  ```

  ```bash All addresses (authenticated) theme={null}
  curl --request GET \
    --url https://api.iterapay.com/public/invoices/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f/addresses \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Single address theme={null}
  {
    "address": "TRR8WbHdkLBqNJAXmjS5jT4xEtd7X9bWb",
    "amount": "100.500000",
    "expiresAt": "2024-01-15T12:00:00Z"
  }
  ```

  ```json 200 All addresses theme={null}
  [
    {
      "address": "TRR8WbHdkLBqNJAXmjS5jT4xEtd7X9bWb",
      "amount": "100.500000",
      "expiresAt": "2024-01-15T12:00:00Z"
    },
    {
      "address": "0x4e9ce36e442e55ecd9025b9a6e0d88485d628a67",
      "amount": "100.500000",
      "expiresAt": "2024-01-15T12:00:00Z"
    }
  ]
  ```
</ResponseExample>