Skip to main content
GET
/
companies
Get company data
curl --request GET \
  --url https://clientapi.woku.app/companies \
  --header 'Authorization: Bearer <token>'
{
  "company": {
    "_id": "507f1f77bcf86cd799439020",
    "name": "Acme Corporation",
    "email": "contact@acme.com"
  },
  "folders": [
    {
      "_id": "<string>",
      "name": "Store #123",
      "secondaryKey": "store-123",
      "wokusCount": 15
    }
  ],
  "wokus": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "description": "Customer Service Experience - Store #123",
      "createdBy": "507f1f77bcf86cd799439012",
      "companyId": "507f1f77bcf86cd799439013",
      "folderId": "507f1f77bcf86cd799439014",
      "file": {
        "filename": "product-image.webp",
        "type": "image",
        "url": "https://cdn.woku.app/files/product-image.webp"
      },
      "qualifications": [
        {
          "_id": "507f1f77bcf86cd799439015",
          "qualification": 5,
          "createdBy": "<string>",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ],
      "textnotes": [
        {
          "_id": "507f1f77bcf86cd799439016",
          "qualification": {
            "qualification": 5
          },
          "description": "Excellent service!",
          "anonymous": false,
          "feedbackType": "positive",
          "clientId": "<string>",
          "validated": true,
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ],
      "voicemails": [
        {
          "_id": "507f1f77bcf86cd799439017",
          "qualification": {
            "qualification": 4
          },
          "file": {
            "filename": "voicemail.mp4",
            "url": "<string>"
          },
          "transcription": "I had a great experience with your service...",
          "anonymous": false,
          "feedbackType": "positive",
          "clientId": "<string>",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      ],
      "feedbacksSummary": "Customers generally praise the helpful staff and quick service...",
      "closed": false,
      "createdAt": "2026-01-20T10:30:00.000Z",
      "updatedAt": "2026-01-20T15:45:00.000Z"
    }
  ],
  "nps": {
    "score": 45,
    "totalResponses": 250
  }
}

Authorizations

Authorization
string
header
required

Company API key. Obtain this from your Woku dashboard under Settings > API Keys.

Response

Company data retrieved successfully

company
object
folders
object[]

Array of folders belonging to the company

wokus
object[]

Array of wokus belonging to the company

nps
object