Returns basic information relevant to both internal and external user.
Get users by id or email
https://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/users
Authentication | Personal access token, OAuth integration |
Scope | enterprise.user:read |
User role | Enterprise admin |
Billing plans | Enterprise (pre-2023.08 legacy plan), Enterprise Scale |
optional< array of strings > User Ids to search by. If the request does not have any email addresses, you must include at least one userId. | |
optional< array of strings > Email addresses to search by. If the request does not have any userIds, you must include at least one email address. | |
optional< array of ("collaborations" | "aggregated" | "descendants") > Allows optionally including collaborations in response. |
array of the below object
|
$curl "https://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/users\?email[]=foo%40bar.com&id[]=usrsOEchC9xuwRgKk&include[]=collaborations" \-H "Authorization: Bearer YOUR_TOKEN"
{"users": [{"collaborations": {"baseCollaborations": [{"baseId": "appLkNDICXNqxSDhG","createdTime": "2019-01-03T12:33:12.421Z","grantedByUserId": "usrqccqnMB2eHylqB","permissionLevel": "edit"}],"interfaceCollaborations": [],"workspaceCollaborations": []},"createdTime": "2019-01-03T12:33:12.421Z","email": "baz@bar.com","groups": [{"id": "ugpR8ZT9KtIgp8Bh3"}],"id": "usrsOEchC9xuwRgKk","invitedToAirtableByUserId": "usrGcrteE5fUMqq0R","isAdmin": false,"isManaged": true,"isServiceAccount": false,"isSsoRequired": true,"isTwoFactorAuthEnabled": false,"lastActivityTime": "2019-01-03T12:33:12.421Z","name": "baz bar","state": "provisioned"},{"collaborations": {"baseCollaborations": [{"baseId": "appLkNDICXNqxSDhG","createdTime": "2019-01-03T12:33:12.421Z","grantedByUserId": "usrqccqnMB2eHylqB","permissionLevel": "edit"}],"interfaceCollaborations": [{"baseId": "appLkNDICXNqxSDhG","createdTime": "2019-01-03T12:33:12.421Z","grantedByUserId": "usrogvSbotRtzdtZW","interfaceId": "pbdyGA3PsOziEHPDE","permissionLevel": "edit"}],"workspaceCollaborations": [{"createdTime": "2019-01-03T12:33:12.421Z","grantedByUserId": "usrGcrteE5fUMqq0R","permissionLevel": "owner","workspaceId": "wspmhESAta6clCCwF"}]},"createdTime": "2019-01-03T12:33:12.421Z","email": "foo@bar.com","groups": [{"id": "ugp1mKGb3KXUyQfOZ"},{"id": "ugpR8ZT9KtIgp8Bh3"}],"id": "usrL2PNC5o3H4lBEi","invitedToAirtableByUserId": "usrsOEchC9xuwRgKk","isAdmin": true,"isManaged": true,"isServiceAccount": false,"isSsoRequired": true,"isTwoFactorAuthEnabled": false,"lastActivityTime": "2019-01-03T12:33:12.421Z","name": "foo baz","state": "provisioned"}]}