Invitations

An invitation is a subcontractor’s access to one package on a project. You invite them, or they ask for access and you approve it. The invitation then records whether they downloaded the documents and how they responded.

GET /api/tender/builder/v1/companies/{companyId}/tender-projects/{projectId}/invitations
GET /api/tender/builder/v1/companies/{companyId}/tender-projects/{projectId}/invitations/{invitationId}

Both need invitations/read.

The invitation object

Field	Type	Notes
`id`	string	Numeric string.
`packageId`	string	The package the invitation is for.
`packageName`	string
`quotesDueDate`	string \| null	`YYYY-MM-DD`.
`invitee`	object	Who was invited. See below.
`access`	object	How they came to have, or lose, access. See below.
`response`	object	How they responded. See below.

`invitee`

Field	Type	Notes
`addressBookCompanyId`	string \| null	`null` if the subcontractor asked for access without being in your address book.
`addressBookContactId`	string \| null	As above.
`companyName`	string \| null
`contactName`	string \| null

Contact details such as email addresses and phone numbers are not included. Read them from your address book, which needs address-book/read.

`access`

Field	Type	Notes
`status`	string	One of the statuses below.
`requestedAt`	string \| null	ISO 8601 timestamp. When the subcontractor asked for access.
`approvedAt`	string \| null	When access was granted.
`invitedAt`	string \| null	When you sent the invitation.
`declinedAt`	string \| null	When you declined their request.
`declinedReason`	string \| null	Your reason for declining.
`revokedAt`	string \| null	When you withdrew access.

`status`	Meaning
`invited`	You invited them.
`requested`	They asked for access and are waiting for you to approve or decline it.
`approved`	You, or auto-approval, granted their request.
`declined`	You declined their request.
`revoked`	You withdrew access after inviting or approving them.

`response`

Field	Type	Notes
`quotingStatus`	string \| null	`quoting`, `quoted`, `quoted_outside_e1` or `not_quoting`; `null` until they respond.
`notQuotingReason`	string \| null	Why they aren’t quoting, when they said.
`lastDownloadedAt`	string \| null	When they last downloaded the package’s documents.
`quoteIds`	string[]	The current revision of each quote they sent. Read them with the Quotes endpoints, which need `quotes/read`.

Listing invitations

GET .../invitations returns every invitation on the project, oldest first, in every access status. Add packageId to list one package’s invitations.

Query parameter	Notes
`packageId`	Optional. Only list invitations to this package.
`limit`	Optional. Page size, 1 to 100. Defaults to 25.
`cursor`	Optional. The `_metadata.nextCursor` from the previous page.

The list is paginated. While _metadata.hasNextPage is true, request the next page with cursor set to _metadata.nextCursor and the same packageId. The cursor is signed and tied to the project and package filter it came from: pass it back unchanged. A cursor that was modified, or that came from a different listing, returns 400.

curl -sS \
  -H "Authorization: Bearer $E1_ACCESS_TOKEN" \
  -H "x-e1-client-id: $E1_CLIENT_ID" \
  "$E1_API_BASE/api/tender/builder/v1/companies/$E1_COMPANY_ID/tender-projects/198578/invitations?packageId=1930318"

{
  "data": [
    {
      "id": "7001",
      "packageId": "1930318",
      "packageName": "Joinery",
      "quotesDueDate": "2026-10-01",
      "invitee": {
        "addressBookCompanyId": "3001",
        "addressBookContactId": "4001",
        "companyName": "Acme Joinery",
        "contactName": "Jo Smith"
      },
      "access": {
        "status": "invited",
        "requestedAt": null,
        "approvedAt": "2026-09-01T09:00:00+10:00",
        "invitedAt": "2026-09-01T09:00:00+10:00",
        "declinedAt": null,
        "declinedReason": null,
        "revokedAt": null
      },
      "response": {
        "quotingStatus": "quoted",
        "notQuotingReason": null,
        "lastDownloadedAt": "2026-09-02T10:30:00+10:00",
        "quoteIds": ["9001"]
      }
    }
  ],
  "_metadata": {
    "nextCursor": null,
    "hasNextPage": false
  }
}

Reading an invitation

GET .../invitations/{invitationId} returns one invitation as data, without _metadata.

Errors

Status	When
`400`	`limit`, `packageId` or the invitation ID isn’t valid, or the cursor was modified or came from a different listing (`INVALID_CURSOR`).
`401`	The token doesn’t carry `invitations/read`.
`403`	The builder restricts the project to certain team members.
`404`	The project, package or invitation doesn’t exist, or belongs to another company.