Get available contacts for potential invoice

What are Invoice Contacts? Returns a list of organization members (contacts) from the customer organization who can be selected as invoice recipients. These contacts are the people who will receive the invoice when it is sent via email. You can set a contact for each potential invoice to specify who should receive the final invoice document.

Invoice ID Format: The invoice ID follows the format: {type}::{projectId}::{dateFrom}::{dateTo}

Example: SingleProject::0e9d033a-ab41-4212-8637-66c4e3b01fe2::2025-10-01::2025-10-31 The projectId is extracted from the invoice ID to determine which organization is the customer, and then returns contacts from that organization.

What data is returned:

List of organization members from the project 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 potential invoice
Select a contact ID from the list
Use the PATCH endpoint to set the contactId for the potential invoice
When the invoice is finalized and sent, it will be emailed to this contact

Permission requirements: Requires Invoices.manage permission and access to the project to view contacts.

GET/billing/potential-invoices/{id}/contacts

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Potential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}

Responses

200

Invoice 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.

401

Unauthorized - Invalid or missing authentication token

403

User lacks Invoices.manage permission or project access

404

Potential invoice not found

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*Potential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}

Request

curl -X GET "https://leadtime.app/api/public/billing/potential-invoices/SingleProject%3A%3A0e9d033a-ab41-4212-8637-66c4e3b01fe2%3A%3A2025-10-01%3A%3A2025-10-31/contacts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/billing/potential-invoices/SingleProject%3A%3A0e9d033a-ab41-4212-8637-66c4e3b01fe2%3A%3A2025-10-01%3A%3A2025-10-31/contacts", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/billing/potential-invoices/SingleProject%3A%3A0e9d033a-ab41-4212-8637-66c4e3b01fe2%3A%3A2025-10-01%3A%3A2025-10-31/contacts",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "avatarId": {},
    "email": "john.doe@example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "John Doe"
  }
]