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

# List API Request Logs

> Retrieve a paginated list of API request logs for the workspace. Each entry summarizes a single request made with a `pubrio-api-key`, including the path, method, status code, duration, response size, and credit cost. Use the [Look up log details](/api-reference/endpoint/api-keys/logs_lookup) endpoint to fetch the full request/response payload for a specific entry.



## OpenAPI

````yaml en-openapi POST /api_keys/logs
openapi: 3.0.0
info:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/en/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/en/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: Workspace profile information and usage statistics
  - name: Enrichment
    description: Enrich people and company records with detailed B2B data
  - name: Lookalike
    description: Find companies similar to a given company
  - name: Search
    description: Search for people, companies, jobs, news, and advertisements with filters
  - name: Lookup
    description: >-
      Look up detailed information for specific people, companies, jobs, news,
      advertisements, and technologies
  - name: LinkedIn
    description: Look up people and company data via LinkedIn profile URLs
  - name: Redeem
    description: Redeem credits to unlock people contact details (single and batch)
  - name: Channels
    description: Manage outreach channel templates (create, update, delete, list)
  - name: Monitor
    description: Create and manage data monitors with webhooks, statistics, and processing
  - name: Filters
    description: >-
      Retrieve available filter values for search parameters (technologies,
      locations, verticals, etc.)
  - name: API Keys
    description: List and inspect API request logs and usage analytics for API keys
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /api_keys/logs:
    post:
      tags:
        - API Keys
      summary: List API request logs
      description: >-
        Retrieve a paginated list of API request logs for the workspace. Each
        entry summarizes a single request made with a `pubrio-api-key`,
        including the path, method, status code, duration, response size, and
        credit cost. Use the [Look up log
        details](/api-reference/endpoint/api-keys/logs_lookup) endpoint to fetch
        the full request/response payload for a specific entry.
      operationId: api_keys_get_logs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                profile_id:
                  $ref: '#/components/schemas/profile_id'
                page:
                  $ref: '#/components/schemas/page'
                per_page:
                  $ref: '#/components/schemas/per_page'
                order_by:
                  type: string
                  enum:
                    - created_at
                    - duration_ms
                    - status_code
                  default: created_at
                  description: Field to sort the log list by.
                is_ascending_order:
                  type: boolean
                  default: false
                  description: >-
                    Sort direction. `true` for ascending, `false` (default) for
                    descending.
                search_term:
                  type: string
                  description: >-
                    Free-text search across the request path, log type slug, and
                    raw request body.
                log_types:
                  type: array
                  items:
                    type: integer
                  description: Filter by log type IDs.
                log_type_slugs:
                  type: array
                  items:
                    type: string
                  description: >-
                    Filter by log type slugs (e.g. `people_search`,
                    `company_search`).
                status_codes:
                  type: array
                  items:
                    type: integer
                  description: Filter by HTTP status codes (e.g. `[200, 400, 500]`).
                methods:
                  type: array
                  items:
                    type: string
                  description: Filter by HTTP methods (e.g. `["POST", "GET"]`).
      responses:
        '200':
          description: Successful response containing paginated API request logs.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      filters:
                        type: object
                        description: >-
                          Echo of the request filters used to produce this
                          response, with empty values stripped.
                        additionalProperties: true
                  data:
                    type: object
                    properties:
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            description: Current page number.
                          per_page:
                            type: integer
                            description: Number of results per page.
                          total_entries:
                            type: integer
                            description: Total number of log entries.
                          total_pages:
                            type: integer
                            description: Total number of pages.
                          total_display_pages:
                            type: integer
                            description: Maximum number of pages displayable for this plan.
                          is_timeout:
                            type: boolean
                            description: Whether the count query timed out.
                      query_logs:
                        type: array
                        items:
                          type: object
                          properties:
                            query_log_id:
                              type: string
                              format: uuid
                              description: >-
                                Unique identifier of the log entry. Pass to
                                `/api_keys/logs/lookup` to retrieve the full
                                payload.
                            created_at:
                              type: string
                              description: Timestamp when the request was received (UTC).
                            profile_id:
                              type: integer
                              description: >-
                                Workspace profile ID associated with the
                                request.
                            user_id:
                              type: string
                              format: uuid
                              description: User ID associated with the API key.
                            method:
                              type: string
                              description: HTTP method of the request.
                            path:
                              type: string
                              description: Request path.
                            status_code:
                              type: integer
                              description: HTTP status code returned.
                            duration_ms:
                              type: integer
                              description: Request processing duration in milliseconds.
                            log_type_id:
                              type: integer
                              description: >-
                                Internal log type ID. `0` if the request did not
                                map to a billable log type.
                            log_type_slug:
                              type: string
                              nullable: true
                              description: >-
                                Log type slug (e.g. `people_search`). `null` for
                                unbilled requests.
                            log_type_name:
                              type: string
                              nullable: true
                              description: Human-readable log type name.
                            authentication_type:
                              type: string
                              description: >-
                                Authentication mechanism used. Always
                                `pubrio-api-key` for API key requests.
                            authentication_type_name:
                              type: string
                              description: Human-readable authentication type name.
                            masked_authentication:
                              type: string
                              description: >-
                                Masked representation of the API key used for
                                this request.
                            response_size:
                              type: integer
                              description: Size of the response body in bytes.
                            credits:
                              type: number
                              description: Total credits charged for this request.
                            ip:
                              type: string
                              description: Client IP address of the caller.
                            email:
                              type: string
                              description: Email of the user the API key belongs to.
                            nickname:
                              type: string
                              description: Nickname of the user the API key belongs to.
                            user:
                              type: object
                              properties:
                                user_id:
                                  type: string
                                  format: uuid
                                nickname:
                                  type: string
                                email:
                                  type: string
              example:
                metadata:
                  filters:
                    page: 1
                    per_page: 3
                    status_codes:
                      - 200
                data:
                  pagination:
                    page: 1
                    per_page: 3
                    total_entries: 1109
                    total_pages: 370
                    total_display_pages: 250
                    is_timeout: false
                  query_logs:
                    - query_log_id: fc1ce3dd-39f7-4fbd-9d22-569a17115c11
                      created_at: '2026-05-14 12:04:32.243'
                      profile_id: 1
                      user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf
                      method: POST
                      path: /api_keys/usage/daily
                      status_code: 200
                      duration_ms: 1821
                      log_type_id: 0
                      authentication_type: pubrio-api-key
                      masked_authentication: 0••••••••••••••••f39
                      response_size: 2180
                      ip: 127.0.0.1
                      email: you@example.com
                      nickname: Example User
                      user:
                        user_id: 2981d4b3-f8b1-44d8-9759-889f3bfa2faf
                        nickname: Example User
                        email: you@example.com
                      log_type_slug: null
                      credits: 0
                      log_type_name: null
                      authentication_type_name: API Key
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    profile_id:
      type: integer
      description: >-
        Optional. An identifier for the user profile (workspace) making the
        request. This is no longer required as the API key already includes your
        workspace information. If provided, it helps in associating the lookup
        with a specific user, allowing for data retrieval and credit tracking. 

         Check out `user details` endpoints under the Profile tab for more information.
    page:
      type: integer
      example: 1
      description: The page number of the Pubrio data that you want to retrieve.
    per_page:
      type: integer
      example: 25
      description: >-
        The number of search results that should be returned for each page.
        Limited the number of results per page improves the endpoint's
        performance.
  responses:
    general_error:
      description: >-
        Bad request. The request was malformed or contained invalid parameters.
        Check the error code and message for details.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Rate limit exceeded. Too many requests were made in a given time period.
        Retry after the rate limit window resets.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Internal server error. An unexpected error occurred on the server.
        Contact support if the error persists.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        A unique API token that represents the actions you perform through the
        API and the corresponding permissions and operations. You can create it
        through the [Settings](https://dashboard.pubrio.com/#/settings/)
        section.
      in: header

````