Company List

An overview of the Company List endpoint.

Endpoint Description

Retrieve a list of all companies within the R1 Discover platform and their R1 Discover IDs.

HTTP Method

GET /api/v1/company-list/{page}/{limit}

Headers:

• Content-Type: application/json - Specifies that the request body format is JSON.

• Accept: application/json - Indicates that the client expects a JSON response.

• Authorization: Bearer {token} - A valid Bearer token must be provided to authenticate the request.

URL Parameters:

• page (Integer, Required): Specifies the page number in the pagination sequence to retrieve a specific set of results.

• limit (Integer, Required): Specifies the number of records to retrieve per page, controlling the volume of data returned.

Data Dictionary:

• id (Integer): The unique identifier for the company within the R1 Discover system.

• name (String): The name of the company.

Request Examples

Bash

curl --request GET \
    --get "https://api.r1learning.com/api/v1/company-list/1/50" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "Authorization: Bearer {token}"

JavaScript

C# - Http

Response Examples

200: OK

{
  "error": 0,
  "message": "",
  "page": "1",
  "limit": "50",
  "data": {
    "company_list": [
      {
        "id": 1,
        "name": "R1 Learning"
      }
    ]
  }
}

401: Unauthorized

Notes

• Authorization Required: Ensure the provided Bearer token is valid and has sufficient privileges to access the endpoint.

• Response Handling: Implement pagination to manage data effectively, especially when dealing with large datasets.