Back to the index
Rate limits
| Limit | Value |
|---|
| Requests a minute, per key | 6,000 by default. Your administrator sets the limit for each key. |
| Enforced | Not yet. The limit is stored with each key, and the API can start to enforce it. |
Build your client to handle 429 with code rate_limited now:
- Wait, then retry with exponential back-off, for example 1 s, 2 s, 4 s.
- Stop after 5 tries.
- For large loads, use
POST /activities/import
or POST /reference-changes instead of one request per
record.
Size limits
| Item | Limit |
|---|
| Rows in one import | 1,000 |
| Records in one proposal request | 1,000 |
Phase Codes on one activity (phaseCodes) | 1,000 |
Jobs in one apply request (activityIds) | 1,000 |
| Distinct locations in one import group | 100 |
Pairs in a Meet Point audience | 100 |
Records from GET /activities?all=true | 10,000 |
Page size, GET /activities and GET /phase-codes | 1 to 100 (default 25) |
Page size, GET /equipment-catalog | 1 to 200 (default 50) |
Search text (q) | 100 characters |
Field lengths
| Field | Max characters |
|---|
Activity code, Work Order jobCode and equipmentCode | 50 |
Phase Code code | 50 |
Equipment code | 30 |
companyCode | 10 |
divisionCode | 20 |
Audience payClassCode | 30 |
Activity name | 100 |
address | 300 |
timeZone | 64 |
Phase Code and equipment description | 200 |
sourceSystem filter on GET /activities | 20 |
Boundary limits
| Item | Limit |
|---|
Radius of a point boundary (radiusMeters) | 1 to 1,609 m (default 201 m) |
| Points in a drawn boundary | 3 or more |
| Reach of a drawn boundary | No point more than 1 mile from its centre |
Terms of use
Your use of the Matrix TimeCard API is governed by your organisation's customer agreement
with Matrix TimeCard. The legal terms are in that agreement. For questions about the terms,
contact support@matrixtimecard.com.
