Glossary

Terms used throughout these docs.

Term	Meaning
Application	A logical container for an integration, created per partner. Holds credentials, permissions, and company registrations.
Credential	A client_id / client_secret pair issued against an application. Used to obtain OAuth2 bearer tokens.
Permission	The set of scopes an application is allowed to use. Must be in published status to be effective.
Registration	The link between an application and a specific E1 company. Without a registration for a given companyId, the application cannot read that company’s data.
Scope	A named capability carried by the OAuth2 token, e.g. speci-finder/read. The token’s scopes are intersected with the permission’s scopes at request time; the request must carry a scope that the route requires.
Assigned user	For the Supplier API, the E1 user whose Speci-finder keywords should be queried. A credential is bound to an assignedUserId at issuance.
Company	An E1 organisation (the supplier, in Supplier API terms). Identified by a numeric companyId.
Tender project	A construction project at the tendering stage — builders are inviting quotes from suppliers.
Procurement project	A construction project at the procurement stage — contracts are being awarded and packages distributed.
Stage	E1’s internal term for a unit of work within a project (e.g. “Bulk Earthworks”) with a type (Tender or Procurement), a lead builder, and a quote due date. In the Supplier API response these appear in the tenders array regardless of type.
Tender	The Supplier API wire-format name for a Stage. Each entry in the response’s tenders array carries the stage’s type, builder, dates, and matched keywords.
Package	A scope of work within a project that suppliers can quote against.
Speci-finder	E1’s supplier-side product that matches a supplier user’s keywords against live tenders (both Tender and Procurement type).
Matched keyword	One of the assigned user’s Speci-finder keywords that caused a tender to match. Returned on each tender in the Supplier API response.
Open tender	A tender whose quotes are not past due and are within the near-term window. Closed tenders are excluded from Supplier API responses.
Ascension	The E1 backend platform that owns the underlying project, company, and user data. The External API forwards authorised requests to Ascension.