FAQ

How fresh is the data?

Data is read live from the E1 platform on each request. See Data freshness for detail on what “currently open” means and why a response might be empty.

How often should I poll?

Daily is sufficient for most integrations. Hourly is reasonable if your product surfaces real-time match notifications. Faster than hourly is over-engineering — upstream data does not change on a sub-minute cadence. See Rate limits — Fair use.

Can I filter, sort, or paginate?

• Filter / sort: no. The endpoint takes no query parameters — you receive the full set of matched open projects each call; filter and sort client-side.
• Paginate: no — the endpoint does not paginate. Response size is naturally bounded by the number of currently-open tenders matching the assigned user’s keywords.

See Conventions for why.

Do you support webhooks?

No. The API is pull-based only. Poll on a daily or hourly cadence depending on your product’s needs.

How do I rotate a client_secret?

Contact E1 support. We’ll issue a new credential alongside the old one so you can deploy without downtime, then revoke the old one on your go-ahead. See Authentication — Secret rotation.

What happens if my token expires mid-request?

An expired token returns 401 Unauthorised. Discard the cached token, fetch a new one from the token endpoint, and retry the request once. See Authentication — Token lifecycle.

Why did my request return 200 OK with data: []?

It succeeded but nothing matched. Common causes listed in Data freshness — Why your response might be empty.

Why am I getting 401 with just Unauthorised and no detail?

Authorization failures deliberately surface a generic body rather than disclosing the specific cause. Work through the checklist in Errors — 401.

Can I use a single credential for multiple users’ Speci-finder keywords?

No. Supplier API credentials are bound at issuance to a single assignedUserId. If you need to query multiple users’ keywords, request one credential per user from E1. See Authorization — The assigned user.

Is there an SDK?

Not currently. Partners consume raw HTTP, or generate a client from the OpenAPI spec. The spec conforms to OpenAPI 3.1.

When will the Builder API be available?

The Builder API is in development and is not exposed in production today. It will be documented here when it reaches GA.