Skip to main content
Follow these steps to make your first Pleo API call using curl.

Before You Begin

Example 1 – GET a List of Employees

Requirements

  • Standalone API Key with users.read API Scope

Endpoint

https://external.staging.pleo.io/v2/employees

cURL Template

Use the template below and replace your API Key:
  • YOUR-API-KEY → your generated Standalone API Key

Execute the Request

Example with placeholders replaced:

Sample Response

Example 2 – GET Details of a Specific Company

Requirements

  • Standalone API Key with companies:read API Scope

Endpoint

https://external.pleo.io/v1/companies/{companyId}

cURL Template

Use the template below and replace your API Key and Company ID:
  • YOUR-API-KEY → your generated Standalone API Key
  • {companyId} → the Company ID you want details for
    Tip: You can extract the companyId from the response in Example 1

Execute the Request

Example with placeholders replaced:

Sample Response

Result

  • You’ve successfully made API requests using your Standalone API Key
  • You’ve verified that your API Key has the correct permissions and scope
  • You understand how to extract IDs (like companyId) for subsequent requests

What Comes Next?


this how-to is part of: