Get invoice contacts for a project
Returns a list of organization members (contacts) from the project’s customer organization who can be selected as invoice recipients. These contacts are the people who will receive invoices when they are sent via email.
What are Invoice Contacts? Invoice contacts are organization members from the customer organization associated with the project. These are the people who can receive invoices via email. Each contact must have a valid email address to receive invoices.
What data is returned:
- List of organization members from the project’s customer organization
- Each contact includes ID (UUID), full name, avatar file ID (if available), and email address
- Contacts are sorted alphabetically by first name, then last name
- Only active (non-deleted) organization members are returned
How to use:
- Get the list of available contacts for a project
- Select a contact ID from the list
- Use the POST /billing/setInvoiceContactId endpoint to set the contact for an invoice
- When the invoice is sent, it will be emailed to this contact
Permission requirements: Requires Invoices.manage permission and access to the project to view contacts.
/billing/invoices/invoiceContacts/{projectId}AuthorizationOAuth2 access token · headerrequiredapi:readAuthorizationBearer token (JWT) · headerrequiredprojectIdstring<uuid>requiredProject ID (UUID) to get contacts for
Invoice contacts retrieved successfully
InvoiceContactResponseDtoavatarIdobject<uuid> | nullrequiredAvatar file ID (UUID) if the contact has a profile picture. Null if no avatar is set.
emailobject | nullrequiredEmail address of the contact. This is where the invoice will be sent when finalized. Null if the contact does not have an email address.
idstring<uuid>requiredContact ID (UUID) of the organization member. Use this ID when setting the contactId for a potential invoice via the PATCH endpoint.
namestringrequiredFull name of the contact (organization member). This is the person who will receive the invoice when it is sent via email.
Unauthorized - Invalid or missing authentication token
Forbidden - Insufficient API scopes or permissions
Project not found or access denied