GET/api/v1/companies/{id}/details

Get Company Details tab payload

Returns the same aggregate shown in the platform company Details tab: commercial state (sales moment), latest AI company status (current narrative, needs, objections), and the suggested-actions/signals bundle.

Authentication

Send your API key in the x-api-key header.

x-api-keybearer

Parameters

idrequired

path · string

Company ID.

Responses

200

PublicApiGetCompanyDetailsTabResponseDto

statusCoderequired

number

countrequired

number

errorrequired

string

datarequired

PublicApiCompanyDetailsTabDto

Example response

json

{
  "statusCode": 200,
  "count": 0,
  "error": null,
  "data": {
    "commercialState": {
      "state": "exploration",
      "confidence": 0,
      "confidenceLevel": "low",
      "whyNow": "",
      "subMotives": [
        ""
      ],
      "recommendedAction": {
        "actionType": "next_step",
        "instruction": "",
        "suggestedMessage": "",
        "deadline": ""
      },
      "lastCalculatedAt": "",
      "stateChangedAt": "",
      "previousState": "exploration",
      "triggerSignals": [
        ""
      ]
    },
    "aiStatus": {
      "id": "",
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-01-15T10:00:00.000Z",
      "state": {
        "currentState": [
          ""
        ],
        "needs": [
          ""
        ],
        "objections": [
          ""
        ]
      }
    },
    "suggestedActions": {
      "suggestedActions": [
        {
          "id": "",
          "title": "",
          "description": "",
          "priority": "high",
          "category": "positive",
          "relatedSignals": [
            ""
          ],
          "confidence": 0,
          "relevanceScore": 0,
          "firstDetectedAt": "",
          "lastDetectedAt": "",
          "occurrences": 0,
          "activityIds": [
            ""
          ],
          "activityNames": [
            ""
          ],
          "activityTypes": [
            ""
          ]
        }
      ],
      "signals": [
        {
          "signalTypeCode": "",
          "signalTypeTitle": "",
          "signalTypeDescription": "",
          "signalTypeCategory": "positive",
          "value": "",
          "changeType": null,
          "detectedAt": "",
          "activityId": "",
          "activityName": "",
          "activityType": "",
          "evidence": [
            {
              "text": "",
              "start": 0,
              "end": 0
            }
          ],
          "relevanceScore": 0
        }
      ],
      "lastUpdated": "",
      "metadata": {
        "totalSignals": 0,
        "signalsByCategory": {
          "positive": 0,
          "risk": 0,
          "neutral": 0
        },
        "decayHalfLifeDays": 0
      }
    }
  }
}

401Unauthorized - missing or invalid API key or Bearer token