Developers

Partner API

beta

Integrate with Launchr. The API is in beta. Endpoints can still change, and we version under /v1 so your integration does not break without notice.

Getting started

Every call goes over HTTPS to the base URL https://launchr.dk/api/v1. Authenticate with an API key in an Authorization header. You create keys inside Launchr under Settings, Partner API; each key reaches only its own organization's data and can be revoked at any time.

curl https://launchr.dk/api/v1/me \
  -H "Authorization: Bearer lk_…"

Endpoints

GET/me· Who am I

Confirms that the key works and returns the organization it belongs to. Call this first to test your setup.

Example response

{
  "meta": {
    "version": "v1",
    "status": "beta"
  },
  "data": {
    "organization": {
      "id": "org_…",
      "name": "Eksempel A/S"
    }
  }
}

GET/orders· List orders

Returns the organization's media buys (up to 100, newest first) in a stable set of fields.

Example response

{
  "meta": {
    "version": "v1",
    "status": "beta"
  },
  "data": {
    "orders": [
      {
        "id": "…",
        "providers": [
          "tv2_connect",
          "viaplay"
        ],
        "advertiserName": "Annoncørens navn",
        "campaignName": "Kendskab Q2",
        "budgetDkk": 50000,
        "startDate": "2026-06-01",
        "endDate": "2026-06-21",
        "status": "ordered",
        "externalReference": "VIA-12345",
        "createdAt": "2026-05-21T10:00:00.000Z"
      }
    ]
  }
}

Errors and versioning

Errors come back with a matching HTTP status code and a JSON object holding an error.message field. A missing or invalid key returns 401. Every response carries a meta field with the version and the status (beta).

The full description is machine readable as an OpenAPI 3.1 spec. Import it into Postman or generate a client from it.

Planning an integration? Write to support@launchr.dk and we will find the right model together.