Get Billing Details

Retrieve the billing contact and address information for the organization.

Request

GET /organization/billing

Authentication

Requires an Admin Bearer JWT token.

Authorization: Bearer <access_token>

Query Parameters

None.

Response

Returns the billing details object.

Success Response

Status Code: 200 OK

Response Body:

{
  "companyName": "Example Corp",
  "billingContactName": "Jane Smith",
  "billingEmail": "[email protected]",
  "billingAddressLine1": "123 Main Street",
  "billingAddressLine2": "Suite 400",
  "billingCity": "San Francisco",
  "billingPostalCode": "94105",
  "billingState": "California",
  "billingCountry": "United States",
  "vatNumber": "US123456789"
}

Response Fields

Field	Type	Description
companyName	string	Legal company name
billingContactName	string	Name of billing contact person
billingEmail	string	Email address for billing notifications
billingAddressLine1	string	Primary address line
billingAddressLine2	string	Secondary address line (apartment, suite, etc.)
billingCity	string	City
billingPostalCode	string	Postal or ZIP code
billingState	string	State, province, or region
billingCountry	string	Country
vatNumber	string	VAT/Tax identification number (if applicable)

Errors

Status Code	Error Code	Description
401	UNAUTHORIZED	Missing or invalid JWT token
403	FORBIDDEN	User does not have admin privileges
404	NOT_FOUND	Billing details not yet configured for the organization

Example

Request

curl -X GET https://api.entryguard.io/api/v1/organization/billing \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Response

{
  "companyName": "Example Corp",
  "billingContactName": "Jane Smith",
  "billingEmail": "[email protected]",
  "billingAddressLine1": "123 Main Street",
  "billingAddressLine2": "Suite 400",
  "billingCity": "San Francisco",
  "billingPostalCode": "94105",
  "billingState": "California",
  "billingCountry": "United States",
  "vatNumber": "US123456789"
}

Notes

• Billing details must be configured before subscribing to a paid plan.
• The billing email receives all payment-related notifications including receipts and failed payment alerts.
• VAT number is optional but recommended for businesses in VAT-applicable regions to ensure correct tax calculation.