Skip to main content

​
Account Type Configuration

Billing details control invoice formatting and account type handling. Some countries has specific constraints. Check this page before proceed.

​
Retrieve Current Billing Details

curl -X GET "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/billing-details/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
Response: 
{
  "country": null,
  "city": null,
  "tax_id": null,
  "account_type": "personal",
  "company_name": null,
  "vat_id": null,
  "line1": null,
  "postal_code": null,
  "first_name": null,
  "last_name": null
}

​
Configure Personal Account

curl -X PUT "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/billing-details/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "de",
    "city": "Berlin",
    "tax_id": "DE123456789",
    "account_type": "personal",
	"line1": "BeKarl-Marx-Alleerlin",
    "postal_code": "10243",
    "first_name": "Example",
    "last_name": "Sample"
  }'
Response: 
{
  "country": "de",
  "city": "Berlin",
  "tax_id": "DE123456789",
  "account_type": "personal",
  "company_name": null,
  "vat_id": null,
  "line1": "BeKarl-Marx-Alleerlin",
  "postal_code": "10243",
  "first_name": "Example",
  "last_name": "Sample"
}

​
Configure Business Account

curl -X PUT "https://connect.cariqa.com/api/v1/users/9405cf8c-8375-4373-b4d3-b61f9a0c01eb/billing-details/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "de",
    "city": "Berlin",
    "account_type": "business",
    "company_name": "CompanyName",
    "vat_id": "DE123456789",
    "line1": "BeKarl-Marx-Alleerlin",
    "postal_code": "10243",
    "first_name": "Example",
    "last_name": "Sample"
  }'
Response: 
{
  "country": "de",
  "city": "Berlin",
  "tax_id": null,
  "account_type": "business",
  "company_name": "CompanyName",
  "vat_id": "DE123456789",
  "line1": "BeKarl-Marx-Alleerlin",
  "postal_code": "10243",
  "first_name": "Example",
  "last_name": "Sample"
}

​
Account Type Impact

  • Personal Account: Uses first and last names on invoices, personal TAX ID in case of need
  • Business Account: Uses company name and VAT ID for professional invoices with proper tax handling
  • Invoice Generation: Billing details ensure proper identity and formatting for payment flows