Zum Inhalt springen
Leadtime
Deutsch
Esc
navigateopen⌘Jpreview

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:

  1. Get the list of available contacts for a potential invoice
  2. Select a contact ID from the list
  3. Use the PATCH endpoint to set the contactId for the potential invoice
  4. 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
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
idstringrequired
Potential invoice ID in format: {type}::{projectId}::{dateFrom}::{dateTo}
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
403User lacks Invoices.manage permission or project access
404Potential invoice not found
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"
Response
[
  {
    "avatarId": {},
    "email": "john.doe@example.com",
    "id": "<uuid>",
    "name": "John Doe"
  }
]