Skip to main content

Partner API: legal entities

Your legal entities are the companies payroll is actually run under. Their ids are what the entity_id filter on the other endpoints accepts.

Written by Vaibhav Kashyap

Scopes used on this page: entities:read. Calling an endpoint your key was not granted the scope for returns 403 insufficient_scope.

Every call below needs your API key — see Partner API: authentication and your first call — and every response follows the paging and field-selection rules in Partner API: pagination, field selection and identifiers.

GET /v1/entities

The active legal entities in your tenant. Their entity_id is what the ?entity_id= filter on the payroll, contractor and employee endpoints takes.

Scope required: entities:read.

This endpoint takes no query parameters.

Fields on each record: entity_id, entity_name, is_active, is_default, legal_name.

Example:

curl -s "https://api.asanify.com/v1/entities" \
  -H "Authorization: Bearer $ASANIFY_API_KEY"
Did this answer your question?