> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wokelo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Status

> Retrieves the current status of a previously submitted async API request.

## Overview

Retrieves the current status of a previously submitted API request.

## Endpoint Details

* **Method:** GET
* **Endpoint:** `/api/enterprise/request/status/`

## Authentication requirements

* Include a valid JWT token in your request header
* If you don't have a token yet, you can get one from the `/auth/token/` endpoint first.

## Request

### Request Parameters

#### Header Parameters

<ParamField header="Authorization" type="string" required>
  JWT token obtained from the Authentication request
</ParamField>

#### URL Parameters

<ParamField query="request_id" type="string" required>
  The unique identifier of the request whose status is being checked. Example: `11db67b6-8345-4837-950f-87bbd8d7dcbe`
</ParamField>

## Response

Successful response will include the `request_id`, `status`, `request_type`, `created_at` and `updated_at` fields.

**Sample Response**

```json theme={"system"}
{
    "request_id": "11db67b6-8345-4837-950f-87bbd8d7dcbe",
    "status": "COMPLETED",
    "request_type": "market_map",
    "created_at": "2026-03-24T18:12:17.787415Z",
    "updated_at": "2026-03-24T18:29:31.041441Z"
}
```

**Possible Status values**

| Status       | Description                                                                     |
| ------------ | ------------------------------------------------------------------------------- |
| `PENDING`    | The request has been received and is queued for processing.                     |
| `PROCESSING` | The request is currently being processed.                                       |
| `COMPLETED`  | The request has finished successfully. Result data is included in the response. |
| `FAILED`     | The request encountered an error during processing.                             |

<ResponseExample>
  ```json 200 theme={"system"}
  {
      "request_id": "b1f10ebf-a251-4e2d-b867-8482ac701987",
      "status": "COMPLETED",
      "request_type": "target_screening",
      "created_at": "2026-03-25T07:24:40.333168Z",
      "updated_at": "2026-03-25T07:30:41.503082Z"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/enterprise/request/status/
openapi: 3.0.3
info:
  title: Wokelo API
  description: >
    Wokelo provides four categories of APIs for company and market intelligence:


    1. **Enrichment** – Company and Industry data using Wokelo database and
    alternative data. Supports multi-company requests.

    2. **Discovery** – Workflows for specific use-cases such as market map,
    target screening, and buyer screening.

    3. **Monitoring** – Real-time news monitoring for companies.

    4. **Workflow Automation** – Wokelo and custom research workflows executed
    within notebooks.


    Enrichment and Discovery APIs are managed through async requests; use the
    Supporting APIs to track status and export results in JSON.

    Workflow APIs are executed within notebooks and support export to PDF, PPT,
    DOC, or JSON.


    **Authentication:** All endpoints (except `/auth/token/`) require a Bearer
    JWT token in the `Authorization` header.
  version: 1.0.0
  contact:
    url: https://docs.wokelo.ai/contact
servers:
  - url: https://api.wokelo.ai
    description: Production server
security: []
tags:
  - name: Authentication
    description: Obtain JWT tokens for API access
  - name: Enrichment
    description: Retrieve structured data for companies and industries
  - name: Discovery
    description: Identify companies via market maps, buyer and target screening
  - name: Monitoring
    description: Real-time company news monitoring
  - name: Workflow Automation
    description: Research notebooks for companies, industries, and custom workflows
  - name: Supporting APIs
    description: >-
      Utility endpoints for search, file upload, request management, and report
      retrieval
externalDocs:
  description: Official Wokelo API Documentation
  url: https://docs.wokelo.ai/overview
paths:
  /api/enterprise/request/status/:
    get:
      tags:
        - Supporting APIs
      summary: Request Status
      description: >-
        Retrieves the current status of a previously submitted async API
        request.
      operationId: requestStatus
      parameters:
        - name: request_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
          example: 11db67b6-8345-4837-950f-87bbd8d7dcbe
      responses:
        '200':
          description: Status returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestStatusResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    RequestStatusResponse:
      type: object
      properties:
        request_id:
          type: string
          format: uuid
          example: b1f10ebf-a251-4e2d-b867-8482ac701987
        status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - COMPLETED
            - FAILED
        request_type:
          type: string
          example: target_screening
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token obtained from the `/auth/token/` endpoint.

````