Skip to main content
GET
/
public-api
/
v1
/
companies
/
{id}
Get Company
curl --request GET \
  --url https://app.cometly.com/public-api/v1/companies/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "domain": "<string>",
  "name": "<string>",
  "message": "<string>"
}

​
Overview

This endpoint allows you to retrieve the details of a company from Cometly.

​
Path Parameters

​
id
integer
required
The unique identifier of the company to retrieve

​
Response

​
Success Response

Returns the company object directly (not wrapped in a data property).
​
id
integer
The unique identifier of the company
​
domain
string
The domain associated with this company
​
name
string
The name associated with this company

​
Error Response

​
message
string
Error description explaining what went wrong

​
Example Requests

curl https://app.cometly.com/public-api/v1/companies/12345 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

​
Status Codes

Status CodeDescription
200Company successfully retrieved
401Missing or invalid API key
403API key doesn’t have permission or subscription is inactive
404Company not found
422Invalid company ID provided
429Too many requests - rate limit exceeded. See Rate Limiting

​
Notes

  • Rate Limit: This endpoint has a limit of 30 requests per minute per Space. See Rate Limiting for details.