Contract Group Items
Retrieve several contract groups by ID.
Available to: All authenticated users
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
Resolve multiple contractGroupIds to their contract group records in a single call. Prefer this over repeated contractGroupItem calls when you need to resolve several IDs at once. Contract groups are read-only reference data.
Common Failure Scenarios
- An ID in
idsthat doesn’t match a contract group is left out of the response array. The call still succeeds, so compare the returned records against the IDs you requested. - The
idsparameter is missing or repeated (HTTP 404), or contains a value that isn’t a number (HTTP 500). - The caller’s user type, or the API key’s permissions, can’t read contract groups. This returns
HTTP 401with"Access is denied".
Error Messages
Related Endpoints
- Use
contractGroupItemto resolve a singlecontractGroupId. - Use
contractGroupListto retrieve every contract group.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
ids
Response
ContractGroup
name
id