Skip to main content

The client organization

With an organization-scoped token (see Authentication and scopes), this endpoint returns only the general identity of the client organization represented by that token. Use its taxIdentifier as MessageSenderIdentifier in TEIF invoices submitted on the client's behalf.

GET /api/core-proxy/organization

Requires invoice:read and a token scoped to an organization that authorized your application.

curl "https://<base_url>/api/core-proxy/organization" \
-H "Authorization: Bearer ORG_SCOPED_TOKEN"

200 OK:

{
"orgId": "5b1e2b7a-4c31-4e2a-9d9a-7b0f9e6a1234",
"orgName": "Société ABC SARL",
"taxIdentifier": "1234567ABCD000"
}

The response is deliberately limited to these three fields. The client's plan, subscription, credits, statistics, API keys, and internal flags remain private.

Use GET /api/partner/authorized-orgs with an app-only token to discover organizations that authorized your application. Then request an organization-scoped token using the selected org_id.

Complete script

The complete Bash workflow guide retrieves the tax identifier automatically. When several organizations are authorized, provide --org-id, --org-tax-id, or use --interactive; the script refuses implicit selection.

Next step

Continue to Submitting and retrieving invoices.