Skip to main content
GET
https://app.cometly.com
/
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>",
  "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

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.