Get the billing profile

Scope billing.read

Returns

16 fields of the 200 answer

idstringrequired

organisationIdstringrequired

legalNamestringrequired

addressLine1stringrequired

addressLine2string or nullrequired

postalCodestringrequired

citystringrequired

countrystringrequired

invoiceEmailstringrequired

vatNumberstring or nullrequired

vatTreatmentenumrequired

NL_STANDARDEU_REVERSE_CHARGENON_EU

viesStatusenumrequired

UNCHECKEDVALIDINVALIDUNAVAILABLE

viesCheckedAtdate-time or nullrequired

viesNamestring or nullrequired

createdAtdate-timerequired

updatedAtdate-timerequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

Request

curl https://api.postbuddy.nl/v1/organisation/billing-profile \
  -H "Authorization: Bearer $POSTBUDDY_API_KEY"

import { PostBuddyClient } from '@postbuddy/sdk';

const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! });

const result = await client.organisation.billingProfile();

import os
from postbuddy import Client

client = Client(os.environ["POSTBUDDY_API_KEY"])

result = client.organisation.billing_profile()

Response

{
  "id": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
  "organisationId": "org_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
  "legalName": "Example",
  "addressLine1": "Oudegracht 112",
  "addressLine2": "2nd floor",
  "postalCode": "3511 AX",
  "city": "Utrecht",
  "country": "NL",
  "invoiceEmail": "sanne@example.com",
  "vatNumber": "NL123456789B01",
  "vatTreatment": "NL_STANDARD",
  "viesStatus": "UNCHECKED",
  "viesCheckedAt": "2026-10-16T09:14:02.000Z",
  "viesName": "Example",
  "createdAt": "2026-10-16T09:14:02.000Z",
  "updatedAt": "2026-10-16T09:14:02.000Z"
}