Skip to main content

Libraries and plugins

Reeds has no official SDKs or plugins. You don't need one to integrate.

Any HTTP client​

The API is plain JSON over HTTPS, so any HTTP client works. Every example in these docs uses curl, the built-in fetch in Node.js 18+, PHP's curl_* functions and Python's requests. Start with the quickstart.

Postman collection​

Every endpoint, grouped like the API reference, with authentication already set up:

Download the Postman collection

  1. In Postman, choose Import and pick the downloaded file.
  2. Open the collection's Variables and set clientId and clientSecret to your test credentials from Dashboard → Developers.
  3. Send any request. Postman gets an access token from POST /oauth/token with your credentials and adds it to every request. Requests that need an Idempotency-Key get a new one on every send. To retry the same request safely, copy the key from the previous send into the header.

The collection is generated from the OpenAPI file each time these docs are published, so the two always match.

Test credentials only

Keep live credentials out of shared Postman workspaces: anyone who can see the collection's variables can use them.

The OpenAPI file​

The complete API contract is published as an OpenAPI file:

/openapi/shipping-v1.yaml

Use it to:

  • Generate a client in your language with a tool such as OpenAPI Generator.
  • Browse the reference in the API reference.

Ready-made integrations​

If you want to use Reeds without writing code, see the integrations directory for what you can use today.

Next steps​