Bidrik API

GET /v1/me

The connected user and account. Used to test a connection.

{
  "id": "66e0c2f1a9b4c3d2e1f00c33",
  "email": "anna@example.com",
  "name": "Anna Andersson",
  "account": { "id": "66e0c2f1a9b4c3d2e1f00d44", "name": "Example Sales AB" },
  "plan": "paid",
  "documents": { "used": 212, "limit": null }
}

plan is paid or trial. On a trial, documents.limit is the number of documents (quotes, templates, product sheets and agreements) the account may have.

GET /v1/quotes

Quotes in the account, newest first.

Response: { "data": [ quote, … ] }. A quote:

{
  "id": "66e0c2f1a9b4c3d2e1f00a11",
  "number": "1042",
  "title": "Office renovation",
  "status": "accepted",
  "value": 125000,
  "currency": "SEK",
  "customer_id": "66e0c2f1a9b4c3d2e1f00b22",
  "customer_name": "Example AB",
  "owner_name": "Anna Andersson",
  "owner_email": "anna@example.com",
  "created_at": "2026-09-01T08:12:00.000Z",
  "updated_at": "2026-09-03T14:40:12.000Z",
  "valid_from": "2026-09-01T00:00:00.000Z",
  "expires_at": "2026-10-01T00:00:00.000Z",
  "sent_at": "2026-09-01T09:00:00.000Z",
  "opened_at": "2026-09-02T07:31:00.000Z",
  "accepted_at": "2026-09-03T14:40:12.000Z",
  "rejected_at": null
}

GET /v1/quotes/{id}

One quote. 404 not_found if it does not exist in the account.

POST /v1/quotes

Creates a draft quote from a template, for a customer. The quote gets the next quote number and the connected user as owner, exactly as if it was created in Bidrik. It is not sent.

POST /v1/quotes
{ "template_id": "66e0c2f1a9b4c3d2e1f00e55", "customer_id": "66e0c2f1a9b4c3d2e1f00b22", "title": "Office renovation" }

Answers 201 with the quote. 402 trial_limit_reached when a trial account has used its documents.

GET /v1/customers

Customers in the account, most recently created first. Response: { "data": [ customer, … ] }. A customer:

{
  "id": "66e0c2f1a9b4c3d2e1f00b22",
  "name": "Example AB",
  "is_private": false,
  "org_number": "556677-8899",
  "customer_number": "1001",
  "email": "hello@example.com",
  "website": "https://example.com",
  "vat_number": "SE556677889901",
  "currency": "SEK",
  "contact": {
    "first_name": "Erik",
    "last_name": "Svensson",
    "email": "erik@example.com",
    "phone": "+46 70 123 45 67",
    "title": "CEO"
  },
  "address": {
    "street": "Storgatan 1",
    "postal_code": "111 22",
    "city": "Stockholm",
    "country": "Sweden"
  },
  "owner_name": "Anna Andersson",
  "owner_email": "anna@example.com",
  "created_at": "2026-08-20T10:00:00.000Z"
}

A private customer (is_private: true) is a person; its name is the contact's name.

GET /v1/customers/search

Finds customers by exact match, ignoring case. Give at least one parameter; several must all match. Returns at most 10, newest first.

Response: { "data": [ customer, … ] }, empty when nothing matches.

GET /v1/customers/{id}

One customer. 404 not_found if it does not exist in the account.

POST /v1/customers

Creates a customer. Its owner is the connected user unless owner_email names another user. Answers 201 with the customer.

POST /v1/customers
{
  "name": "Example AB",
  "org_number": "556677-8899",
  "email": "hello@example.com",
  "contact": { "first_name": "Erik", "last_name": "Svensson", "email": "erik@example.com" },
  "address": { "city": "Stockholm", "country": "Sweden" }
}

Accounts that sync customers with Fortnox answer 409 fortnox_sync_active.

PATCH /v1/customers/{id}

Updates the fields you send; everything else is kept. Same fields as POST /v1/customers. An empty string leaves a field unchanged; send null to clear it. Answers 200 with the customer.

PATCH /v1/customers/66e0c2f1a9b4c3d2e1f00b22
{ "email": "billing@example.com", "contact": { "phone": "+46 70 765 43 21" } }

GET /v1/templates

The account's quote templates, by name. Used to pick a template for POST /v1/quotes.

{ "data": [ { "id": "66e0c2f1a9b4c3d2e1f00e55", "name": "Standard quote", "updated_at": "2026-06-11T12:00:00.000Z" } ] }