Businesses

Retrieve the business record behind a grant: name, org number, VAT number, country, address, and connected platforms. These are the exact fields Valverna snapshots into vendor when a transaction is written.

Retrieve a business

GET /v1/business

Requires the business.read scope — partner tokens without it are rejected with 403 insufficient_scope. A partner vlv_ token is scoped to a single business, so no identifier is needed. Owner-wide personal keys select one of their businesses with the businessId query parameter.

Query parameters

businessId optional

Owner-wide personal keys — which of your businesses to retrieve. Omit for business-pinned keys and app access tokens; if present it must match the credential's business or the request fails 403 forbidden.

Response 200

{
  "id": "biz_9f3a2c81",
  "name": "Kaffekoppen Södermalm",
  "legalName": "Kaffekoppen AB",
  "orgNumber": "556789-1234",
  "vatNumber": "SE556789123401",
  "country": "SE",
  "address": {
    "line1": "Götgatan 45",
    "city": "Stockholm",
    "postalCode": "118 26",
    "country": "SE"
  },
  "connectedPlatforms": ["izettle", "shopify"],
  "createdAt": "2026-01-15T08:00:00Z",
  "updatedAt": "2026-05-20T09:41:30Z"
}