API Reference
  1. UAE e-Invoicing API
  2. Taxpayers

Publish a taxpayer's Business Card

put
https://api.wafeq.com/ae/v1/taxpayers/business-card

Set (replace) the Peppol Directory Business Card for the taxpayer named
in x-ae-taxpayer-id. This does not list the taxpayer yet — call
POST /taxpayers/directory afterwards to (re)index it.

The card is public once listed (name, country, identifiers). Preserves the
taxpayer's Peppol routing (services + certificate); only the card is replaced. Returns
404 if the taxpayer has not completed onboarding (no SMP record yet).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
entities
array of objects
required

0..n business entities (usually 1)

Entities*
Headers
string | null
string
required

Taxpayer ID (txpay_…) that granted your organization access. Required with an organization API key; optional with a taxpayer access token, which already names its taxpayer. Use the taxpayer ID, not its TIN.

string | null

Grant ID (tgr_…) to act through, with an organization API key. The request then has exactly that grant's scopes and fails once the grant is revoked. Without it, the key acts through all of the organization's active grants on the taxpayer.

Responses

Updated 5 days ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago

Did this page help you?