Query Organization

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

GET/companypublic keypuk_

Authentication

Include your public key in the Authorization header.

Authorization: puk_xxx...

Query parameters

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

Response structure

Field	Type	Description
id	String	Organization identifier.
name	String	Organization 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 organization 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://api.auco.ai/v1.5/ext/company' \
  -H 'Authorization: puk_public_key_company'

Python

import requests

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

Node.js

const axios = require('axios');

axios
  .get('https://api.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