Get billing info

GET /api/v2/billing/info Returns the billing (payer) info on file for the authenticated account — the contact, delivery emails, address, and tax ID Apostra uses when issuing your invoices. No payment processing happens through this API; it is collected information only. Check it before your first invoice cycle: an invoice needs at least a payer name and payer address.

Request

curl

curl "https://api.apostra.com/api/v2/billing/info" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

This endpoint takes no parameters.

Response

{
  "billingInfo": {
    "contactName": "Dana Whitfield",
    "email": ["ap@bluepeakbrands.example"],
    "ccEmails": ["finance@bluepeakbrands.example"],
    "phone": "+1 415 555 0182",
    "address": "225 Mission St",
    "address2": "Floor 8",
    "city": "San Francisco",
    "region": "CA",
    "postalCode": "94105",
    "countryAlpha2": "US",
    "taxId": "83-1234567"
  }
}

Field	Type	Notes
`contactName`	string \| null	Billing contact / payer name — who the invoice is addressed to
`email`	array	Email addresses invoices are sent to
`ccEmails`	array	Email addresses CC’d on invoices
`phone`	string \| null	Billing phone number
`address`	string \| null	Billing street address, line 1
`address2`	string \| null	Billing street address, line 2
`city`	string \| null	Billing city
`region`	string \| null	State/province/region
`postalCode`	string \| null	Postal/ZIP code
`countryAlpha2`	string \| null	Billing country (ISO 3166-1 alpha-2)
`taxId`	string \| null	Tax/VAT identifier shown on invoices
`paymentTerms`	string	Payment terms your organization asks sellers for: `net_15`, `net_30`, `net_45`, `net_60`, or `net_90`. `net_60` until you choose. Omitted when choosing payment terms is not yet available for your organization
`paymentTermsChosen`	boolean	`false` while the `net_60` default applies because you have not chosen. Omitted together with `paymentTerms`

Fields are null (emails: empty) until set with Update billing info. See Payment terms for how sellers use your choice.

Errors

401 UNAUTHORIZED — missing or invalid bearer token.

See Errors for the full error contract.

Update billing info

Change the details on file

Billing overview

How invoicing and remittance work

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get billing info

Request

Parameters

Response

Errors

Update billing info

Billing overview

​Request

​Parameters

​Response

​Errors

​Related

Update billing info

Billing overview

Request

Parameters

Response

Errors

Related