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

# List requests

> Returns the organization's requests one by one, newest first by default: when, which member and API key, the feature, the providers tried, the outcome and what it cost. Filter with `feature`, `subfeature`, `provider`, `api_key` (key ids; `0` for the members' personal keys), `user` (member ids), `outcome`, `streaming`, `search` and `tag.<key>=value` (or `exclude_tag.<key>`). A filter takes several values separated by commas. `begin`/`end` are ISO timestamps; the window defaults to the last 7 days and may not exceed 366 days. Page with `limit` (up to 200) and `offset` (up to 10,000; past it, narrow `begin`/`end`). Requires the `manage:read` scope.



## OpenAPI

````yaml https://api.edenai.run/v2/info/splitted-schema/management_api/openapi.json get /v3/manage/usage/requests/
openapi: 3.0.3
info:
  title: Organization Management
  version: '2.0'
  description: Your project description
servers:
  - url: https://api.edenai.run
security: []
paths:
  /v3/manage/usage/requests/:
    get:
      tags:
        - Usage
      summary: List requests
      description: >-
        Returns the organization's requests one by one, newest first by default:
        when, which member and API key, the feature, the providers tried, the
        outcome and what it cost. Filter with `feature`, `subfeature`,
        `provider`, `api_key` (key ids; `0` for the members' personal keys),
        `user` (member ids), `outcome`, `streaming`, `search` and
        `tag.<key>=value` (or `exclude_tag.<key>`). A filter takes several
        values separated by commas. `begin`/`end` are ISO timestamps; the window
        defaults to the last 7 days and may not exceed 366 days. Page with
        `limit` (up to 200) and `offset` (up to 10,000; past it, narrow
        `begin`/`end`). Requires the `manage:read` scope.
      operationId: manage_usage_requests_retrieve
      parameters:
        - in: query
          name: api_key
          schema:
            type: string
        - in: query
          name: api_version
          schema:
            type: string
        - in: query
          name: begin
          schema:
            type: string
            format: date-time
        - in: query
          name: call_type
          schema:
            type: string
        - in: query
          name: end
          schema:
            type: string
            format: date-time
        - in: query
          name: error_kind
          schema:
            type: string
        - in: query
          name: exclude_api_key
          schema:
            type: string
        - in: query
          name: exclude_api_version
          schema:
            type: string
        - in: query
          name: exclude_call_type
          schema:
            type: string
        - in: query
          name: exclude_error_kind
          schema:
            type: string
        - in: query
          name: exclude_feature
          schema:
            type: string
        - in: query
          name: exclude_provider
          schema:
            type: string
        - in: query
          name: exclude_status_code
          schema:
            type: string
        - in: query
          name: exclude_subfeature
          schema:
            type: string
        - in: query
          name: exclude_user
          schema:
            type: string
        - in: query
          name: feature
          schema:
            type: string
        - in: query
          name: limit
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 50
        - in: query
          name: offset
          schema:
            type: integer
            maximum: 10000
            minimum: 0
            default: 0
        - in: query
          name: order
          schema:
            enum:
              - newest
              - oldest
            type: string
            default: newest
            minLength: 1
          description: |-
            * `newest` - newest
            * `oldest` - oldest
        - in: query
          name: outcome
          schema:
            enum:
              - any
              - success
              - error
              - provider_fault
              - caller_fault
              - rate_limit
            type: string
            default: any
            minLength: 1
          description: |-
            * `any` - any
            * `success` - success
            * `error` - error
            * `provider_fault` - provider_fault
            * `caller_fault` - caller_fault
            * `rate_limit` - rate_limit
        - in: query
          name: provider
          schema:
            type: string
        - in: query
          name: search
          schema:
            type: string
        - in: query
          name: status_code
          schema:
            type: string
        - in: query
          name: streaming
          schema:
            type: boolean
            nullable: true
        - in: query
          name: subfeature
          schema:
            type: string
        - in: query
          name: user
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedManageRequestLogList'
          description: ''
      security:
        - ManagementKeyAuth: []
components:
  schemas:
    PaginatedManageRequestLogList:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/ManageRequestLog'
        limit:
          type: integer
        offset:
          type: integer
        total_count:
          type: integer
        next:
          type: string
          format: uri
          nullable: true
        previous:
          type: string
          format: uri
          nullable: true
      required:
        - limit
        - next
        - offset
        - previous
        - results
        - total_count
    ManageRequestLog:
      type: object
      properties:
        request_id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        org_id:
          type: integer
          description: The organization billed for the request.
        user_id:
          type: string
          format: uuid
          nullable: true
        user_email:
          type: string
          format: email
          nullable: true
        user_former:
          type: boolean
          description: Whether the member has left the organization since.
        custom_token_id:
          type: integer
          description: The API key's id, or 0 for a member's personal key.
        custom_token_name:
          type: string
          nullable: true
        custom_token_masked:
          type: string
          nullable: true
          description: The API key's masked value; null for a personal key.
        custom_token_revoked:
          type: boolean
          nullable: true
        custom_token_expired:
          type: boolean
          nullable: true
        call_type:
          type: string
        url:
          type: string
          description: The path the request was sent to.
        method:
          type: string
        api_version:
          type: string
        feature:
          type: string
        subfeature:
          type: string
        job_id:
          type: string
          format: uuid
          nullable: true
          description: The job of an asynchronous request.
        status_code:
          type: integer
          nullable: true
        error_kind:
          type: string
          description: '`none` when the request succeeded.'
        error_message:
          type: string
        providers:
          type: array
          items:
            type: string
        attempt_count:
          type: integer
        is_streaming:
          type: boolean
        is_cached:
          type: boolean
        requested_model:
          type: string
        routing_strategy:
          type: string
        routing_mode:
          type: string
        cost:
          type: number
          format: double
          description: What Eden AI charged for the request.
        latency_ns:
          type: integer
          nullable: true
        tags:
          type: object
          additionalProperties:
            type: string
      required:
        - api_version
        - attempt_count
        - call_type
        - cost
        - created_at
        - custom_token_expired
        - custom_token_id
        - custom_token_masked
        - custom_token_name
        - custom_token_revoked
        - error_kind
        - error_message
        - feature
        - is_cached
        - is_streaming
        - job_id
        - latency_ns
        - method
        - org_id
        - providers
        - request_id
        - requested_model
        - routing_mode
        - routing_strategy
        - status_code
        - subfeature
        - tags
        - url
        - user_email
        - user_former
        - user_id
  securitySchemes:
    ManagementKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: >-
        A management key (created from the organization dashboard or with `POST
        /v3/manage/auth-keys`), sent as `Authorization: Bearer
        <management_key>`. Inference API keys (`sk-eden...`) are not accepted on
        these endpoints.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.