ACH4

Agent Keys4

Agent Tokens7

Agents5

API Keys4

Approvals4

Card Payments2

Card Sessions4

Chargebacks8

Check4

Customers7

Events3

External Accounts5

External Parties4

External Party Accounts3

Invitation Links4

Invitations3

Merchant Reports1

Parties12

Payment Intents5

PaymentRequests7

Payments4

Realtime4

Refunds3

Simulations22

Transactions2

Transfers5

Voice4

Wallets11

Webhooks6

Wire4

Customers

Get customer

Changed on Oct 19, 2026

Get a customer who has authorized an agent

get/customers/{customerId}

Request

Base URL
https://api.natural.com
URL
https://api.natural.com/customers/{customerId}
Auth
HTTP bearer

Path parameters

customerIdstring required

Customer party ID (pty_*).

Headers

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Response

Successful Response

Changes

Oct 19, 2026020f3c6963c7 Revision changes
- info
  added the required property // to the response with the status
Sep 2, 2026c7c12da5915f Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status

Operation history (6 revisions)