Query company

Service to query your company data: name, logo, visual customization options (white label) and the configured webhooks.

GET /v1.5/ext/company HTTP/1.1
HOST: {{api_auco}}
Authorization: {{public_key}}

Authentication

Include your public key in the Authorization header.

Authorization: puk_xxx...

Query parameters

This service does not receive parameters. The company is identified from the public key sent in the Authorization header.

Response structure

Field	Type	Description
id	String	Company identifier.
name	String	Company name.
webhooks	Array	List of configured webhooks. Each element contains id, description, url and header. See Webhooks.
uxOptions	Object	Visual customization options (white label), for example primaryColor and alternateColor.
image	String	URL of the company logo.
webhook	String	(Legacy) URL of the single webhook. Kept for compatibility; use webhooks.
webhookHeader	Object	(Legacy) Header { key, value } of the single webhook. Kept for compatibility; use webhooks.

Legacy fields

webhook and webhookHeader are returned only for legacy integrations. The current notification configuration is done through the webhooks array (see Webhooks).

🧪 Usage example

Curl

curl -X GET 'https://dev.auco.ai/v1.5/ext/company' \
  -H 'Authorization: puk_public_key_company'

Python

import requests

response = requests.get(
  'https://dev.auco.ai/v1.5/ext/company',
  headers={'Authorization': 'puk_public_key_company'}
)
print(response.json())

Node.js

const axios = require('axios');

axios
  .get('https://dev.auco.ai/v1.5/ext/company', {
    headers: { Authorization: 'puk_public_key_company' }
  })
  .then((response) => console.log(response.data));

📥 Response example

{
  "id": "61ba073970df523d9d232a27",
  "name": "Auco",
  "webhooks": [
    {
      "id": "default",
      "description": "Webhook principal",
      "url": "https://miempresa.com/webhooks/auco",
      "header": {
        "key": "Authorization",
        "value": "Bearer ..."
      }
    }
  ],
  "uxOptions": {
    "primaryColor": "#021C30",
    "alternateColor": "#A557F2"
  },
  "image": "https://static.micontrato.co/companies/61ba073970df523d9d232a27/logo.png",
  "webhook": "",
  "webhookHeader": {}
}

⚠️ Error Responses

Code	Description
401	Invalid or missing authentication