Skip to main content
The following Postman collection file is available for download. This collection includes example payloads and automatic JWT token generation for authenticated requests.

​
Prerequisites

Before using this collection, ensure you have:
  • Coinbase Business account
  • CDP API key using ECDSA signature algorithm
  • Downloaded the following files (we will use these to setup Postman):
Recommended: Use ECDSA keys for reliable testing with this Postman collection. While the Invoicing API itself supports both ECDSA and Ed25519 keys, ECDSA provides the most consistent experience in Postman.
The Invoicing APIs use the same authentication environment as other Coinbase Business APIs. You can reuse the Coinbase Developer Platform environment file.

​
1. Setup Postman

1

Access Postman

Use Postman Web to sign in (no installation needed).
Download from Postman Downloads if you prefer a native app
.
2

Import files

Once you are logged into Postman, you can import the files into your workspace through the web interface.Under “Get Started”, click on Import APIs and collections.
If you already have a Postman workspace, you can select Import in the upper-left corner of the screen.
Select both JSON files you downloaded and import them into your Postman workspace.

​
2. Configure your environment

Set up authentication by adding your CDP API key details to Postman.
1

Add your API credentials

In the left sidebar, click on Environments. Select the Coinbase Developer Platform Postman Environment option to see your environment variables.Add these two variables exactly as shown:
VariableValueWhere to find it
nameYour full API key name (with quotes)From the JSON file downloaded when creating your API key
privateKeyYour ECDSA private key (with quotes)From the JSON file downloaded when creating your API key
Example environment variable values:
name: "organizations/12345678-1234-5678-1234-567812345678/apiKeys/abcdef12-3456-7890-abcd-ef1234567890"

privateKey: "-----BEGIN EC PRIVATE KEY-----\nMHcCAQEEIJ8VsC2ifqfxDpq7mnVWdBKnqIRjFFg0zcC9U4RgKHQqoAoGCCqGSM49\nAwEHoUQDQgAEX7M5LCPd6rkeUxIK3/B9+2+3RQFvkEfMU4iN1ABm5VNUqNmRnJv4\nCxcdPIKreo4xuNr2S8Y5SU6IELb8HGc8Ow==\n-----END EC PRIVATE KEY-----\n"
Important:
  • Include the quotes as part of the value
  • Keep the privateKey on one line with \n for line breaks
  • Use an ECDSA key (starts with -----BEGIN EC PRIVATE KEY-----)

​
3. Authenticate and test endpoints

The Postman collection automatically generates a JWT token before each request using your environment variables.
1

Prep the collection

Navigate to the Collections tab in Postman and expand the “Coinbase Business Invoicing Collection” we added earlier.From the Environment dropdown in the upper-right corner, select the Coinbase Developer Platform Postman Environment we just configured.
2

Send your first request

Start with the List Invoices request and click the Send button.You should receive a response similar to the following:
{
    "invoices": []
}
3

Get a specific invoice

  1. Select the Get Invoice request
  2. Update the :invoiceUuid path variable with a valid invoice UUID
  3. Click Send
  4. Review the invoice details in the response

​
Available endpoints

The Invoicing collection includes the following endpoints:
  • List Invoices - Retrieves a paginated list of invoices with optional filtering by status, contact email, and sorting options
  • Get Invoice - Retrieves details of a specific invoice by UUID

​
Troubleshooting

Confirm EnvironmentMake sure the correct environment is selected by checking the check mark to the right of the environment name in Postman.

​
Common issues and solutions

IssueSolution
Using Ed25519 key instead of ECDSAUse ECDSA key - starts with -----BEGIN EC PRIVATE KEY-----
Missing quotes in environment valuesInclude quotes around name and privateKey values
Invalid JSONCheck the environment dropdown is set to your CDP environment
401 Unauthorized errorsCheck JWT generation in Postman Console and verify credentials

​
Need additional help?

  • Documentation: Review the Authentication Guide
  • Community: Join the CDP Discord for support
  • Support: Contact Coinbase Business support with your X-Request-Id from failed requests