List

GET

Lists users within your organization.

Query parameters

cursorstringOptional

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

emailstringOptional

Filters Dev users based on email addresses.

external_identity.idstringOptional

Unique ID of the user in the external source.

external_identity.issuerstringOptional

Issuer of the external identity of the user.

limitintegerOptional

The maximum number of Dev users to return. The default is ‘50’.

mode"after" or "before"Optional

The iteration mode to use, otherwise if not set, then “after” is used.

Allowed values: afterbefore

sort_bystringOptional

Fields to sort the Dev users by and the direction to sort them.

stateenumOptional

Filters Dev users based on state.

Response

This endpoint returns an object.

dev_userslist of objects

The list of Dev users.

next_cursorstringOptional

The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.

prev_cursorstringOptional

The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

GET

1 curl https://api.devrev.ai/dev-users.list \
2      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "dev_users": [
3     {
4       "id": "id",
5       "created_by": {
6         "type": "sys_user",
7         "id": "created_by"
8       },
9       "created_date": "2023-01-01T12:00:00Z",
10       "display_id": "display_id",
11       "display_name": "display_name",
12       "display_picture": {
13         "id": "id"
14       },
15       "email": "email",
16       "experience_start_date": "2023-01-01T12:00:00Z",
17       "external_identities": [
18         {}
19       ],
20       "full_name": "full_name",
21       "job_history": [
22         {
23           "end_date": "2023-01-01T12:00:00Z",
24           "start_date": "2023-01-01T12:00:00Z"
25         }
26       ],
27       "modified_by": {
28         "type": "sys_user",
29         "id": "modified_by"
30       },
31       "modified_date": "2023-01-01T12:00:00Z",
32       "phone_numbers": [
33         "phone_numbers"
34       ],
35       "skills": [
36         {}
37       ],
38       "state": "active"
39     }
40   ],
41   "next_cursor": "next_cursor",
42   "prev_cursor": "prev_cursor"
43 }

Built with

1	curl https://api.devrev.ai/dev-users.list \
2	-H "Authorization: Bearer <token>"

1	{
2	"dev_users": [
3	{
4	"id": "id",
5	"created_by": {
6	"type": "sys_user",
7	"id": "created_by"
8	},
9	"created_date": "2023-01-01T12:00:00Z",
10	"display_id": "display_id",
11	"display_name": "display_name",
12	"display_picture": {
13	"id": "id"
14	},
15	"email": "email",
16	"experience_start_date": "2023-01-01T12:00:00Z",
17	"external_identities": [
18	{}
19	],
20	"full_name": "full_name",
21	"job_history": [
22	{
23	"end_date": "2023-01-01T12:00:00Z",
24	"start_date": "2023-01-01T12:00:00Z"
25	}
26	],
27	"modified_by": {
28	"type": "sys_user",
29	"id": "modified_by"
30	},
31	"modified_date": "2023-01-01T12:00:00Z",
32	"phone_numbers": [
33	"phone_numbers"
34	],
35	"skills": [
36	{}
37	],
38	"state": "active"
39	}
40	],
41	"next_cursor": "next_cursor",
42	"prev_cursor": "prev_cursor"
43	}