ListLearners
GET https://shared-tp-api-test.30a.dev/tp-api/learners
Retrieve a list of training provider learners for the given training provider.
Query Parameters
- cursor string
Cursor to return items after a specific position in the list.
- limit integer
Possible values:
>= 1
and<= 100
Default value:
10
Maximum number of items to return.
- skip integer
Query to retrieve the items starting from that position in the dataset.
- name string
Filter by full name using case-insensitive
partial
match. - email string
Filter by the email address using case-insensitive
partial
match.
Header Parameters
- training-provider-id string required
Responses
- 200
- 400
Default Response
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- id string required
Learner ID.
firstname object required
lastname object required
uniqueSystemIdentifier object required
email object required
phone object required
- created string required
Learner creation date.
- ]
[
{
"id": "string",
"firstname": "string",
"lastname": "string",
"uniqueSystemIdentifier": "string",
"email": "string",
"phone": "string",
"created": "string"
}
]
Default Response
- application/json
- Schema
- Example (from schema)
Schema
- anyOf
- MOD1
- MOD2
statusCode number requiredcode stringError code
error string requiredError key
message string requiredError message
error object required
{
"statusCode": 0,
"code": "string",
"error": "string",
"message": "string"
}
Authorization
name: Authorizationtype: apiKeyin: headerdescription: An Authorization Header with an auth-scheme of BLN including auth-params type, version, entity, key, token and secret. Example: `bln type=api, version=1, entity=user, key=<api-key>, token=<api-token>, secret=<api-secret>`
Request
Request
curl / cURL
curl -L -X GET 'https://shared-tp-api-test.30a.dev/tp-api/learners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
nodejs / axios
curl -L -X GET 'https://shared-tp-api-test.30a.dev/tp-api/learners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
python / requests
curl -L -X GET 'https://shared-tp-api-test.30a.dev/tp-api/learners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
java / okhttp
curl -L -X GET 'https://shared-tp-api-test.30a.dev/tp-api/learners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
csharp / restsharp
curl -L -X GET 'https://shared-tp-api-test.30a.dev/tp-api/learners' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'