Zum Inhalt springen
Leadtime
Deutsch
Esc
↑↓navigieren↵öffnen⌘Jvorschau

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:

  1. Get the list of available contacts for a project
  2. Select a contact ID from the list
  3. Use the POST /billing/setInvoiceContactId endpoint to set the contact for an invoice
  4. 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
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
projectIdstring<uuid>required

Project ID (UUID) to get contacts for

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

Forbidden - Insufficient API scopes or permissions

404

Project not found or access denied

Try it
Server
Authorization
Parameters
Request
curl -X GET "https://leadtime.app/api/public/billing/invoices/invoiceContacts/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {
    "avatarId": {},
    "email": "john.doe@example.com",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "John Doe"
  }
]