Contract Group Finds
Find several contract groups by name.
Available to: All authenticated users
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
Look up multiple contract groups by name in a single call, returning each matching record, including its id. Prefer this over repeated contractGroupFind calls when you need to resolve several names at once. Contract groups are read-only reference data.
Common Failure Scenarios
- A name in
namesthat doesn’t match a contract group is left out of the response array. The call still succeeds, so compare the returned records against the names you requested. - The
namesparameter is missing or repeated (HTTP 404). - 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
contractGroupFindto look up a single contract group by name. - Use
contractGroupItemsto resolve several contract groups byidinstead.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
names
Response
ContractGroup
name
id