Understanding Service Credits and Usage Limits
What is a Service Credit?
A Service Credit is a way to measure API usage in the Beeline Supplier Network. Each credit represents a specific API action that interacts with key data, such as creating records, submitting candidates, or retrieving detailed job information.
Service Credits help ensure fair usage, system efficiency, and scalability, allowing suppliers to manage their API consumption effectively.
This guide outlines where credits apply and how suppliers can manage their API consumption effectively.
Credit Consumption Model
| API Call Type | Credit Cost | Rate Limits |
|---|---|---|
List All Job Postings (GET) |
Included in plan |
100 calls per minute |
GET Job Posting Details |
Included in plan |
100 calls per minute |
List All Workers (GET) |
Included in plan |
100 calls per minute |
GET Worker Details |
Included in plan |
100 calls per minute |
GET Candidate Details |
Included in plan |
100 calls per minute |
Candidate Submission Lifecycle |
5 credits per candidate |
100 calls per minute |
Timesheet Lifecycle |
1 credit per timesheet |
100 calls per minute |
|
The rate limit of 100 calls per minute applies to the total number of API calls made across all endpoints combined, not per endpoint. For example, if you make 60 calls to list jobs and 50 calls to get worker details within the same minute, you will exceed the rate limit since the total is 110 calls. |
How Credits Work
GET Requests for Listings (Jobs & Workers) Are Free – Suppliers can retrieve lists of available job postings and workers at no cost.
Candidate Submission lifecycle is a single charge – Creating a worker, updating their details, submitting, resubmitting, or withdrawing a candidate are all included in the single charge.
For more details, visit our Supplier API Documentation or contact our support team for assistance.