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.

GET/billing/invoices/invoiceContacts/{projectId}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstring<uuid>required

Project ID (UUID) to get contacts for

Responses

200Invoice contacts retrieved successfully

Array of InvoiceContactResponseDto

avatarIdobject<uuid> | nullrequired

Avatar file ID (UUID) if the contact has a profile picture. Null if no avatar is set.

emailobject | nullrequired

Email 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>required

Contact ID (UUID) of the organization member. Use this ID when setting the contactId for a potential invoice via the PATCH endpoint.

namestringrequired

Full name of the contact (organization member). This is the person who will receive the invoice when it is sent via email.

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

404Project not found or access denied

Request

curl -X GET "https://leadtime.app/api/public/billing/invoices/invoiceContacts/%3Cuuid%3E" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/billing/invoices/invoiceContacts/%3Cuuid%3E", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/billing/invoices/invoiceContacts/%3Cuuid%3E",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "avatarId": {},
    "email": "john.doe@example.com",
    "id": "<uuid>",
    "name": "John Doe"
  }
]