Developers

Your organization’s documents and payments, over one API.

Rivet’s v1 API: documents, payments and treasury — and document writes where your environment has them enabled. Keys act as your organization and are managed by its admins in Settings — one OpenAPI contract, served by the build that answers it.

Quickstart

Three steps to your first page of documents.

  1. Step 1
    Create an account

    The normal Rivet sign-up. There is no separate developer account — API keys belong to your organization.

  2. Step 2
    Mint a key in Settings → Developers

    An organization admin names the key and picks its scopes. The secret is shown once; only its hash is kept.

  3. Step 3
    Make your first request

    Send the key as a bearer token. The key is your organization — there's no org id to pass.

First request
curl https://api.rivet.network/v1/documents?type=invoice&limit=2 \
  -H "Authorization: Bearer rk_live_Kq3Z…"

Keys minted on staging start with rk_test_ and only work against the staging host. The full walkthrough — pagination, errors, rotation — is in the reference.

What’s in v1

Org-scoped, one contract.

A key acts as your organization and only ever sees your own side of a connection — reads across documents, payments and treasury, plus document writes where your environment has them enabled. Every response carries the spec version it was produced under.

Documents Coming

Invoices, bills, purchase orders, quotes and the rest — both directions, labelled the way your team sees them.

Payments Coming

Payment context per document and the payment methods on file.

Treasury Coming

Your treasury accounts and their ledger-derived balances, for a verified organization.

Start with an account. Keys come with it.