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

# Get API call logs

> Returns a paginated log of the API calls your organisation has made, newest first.

<Note> Free. This call does not consume credits. </Note>

## What you need

Nothing beyond your API key.

## Behaviour

- Ordered newest first.
- Page through with `page` and `limit`.
- Filter by time window with `from` / `to` (ISO 8601 datetime, minute granularity).
- The response carries an `X-Total-Count` header and RFC 5988 `Link` pagination links.
- Each entry includes `credits_consumed` and `request_id`.

## What you do next

- **Chase a specific call.** Quote a log entry's `request_id` when contacting API support to point them at that exact call.




## OpenAPI

````yaml /api-ref/bundle_api.yaml get /logs
openapi: 3.0.0
info:
  title: Specter API
  termsOfService: https://tryspecter.com/terms/
  contact:
    name: API support
    email: api-support@tryspecter.com
  version: 1.0.0
servers:
  - description: Production
    url: https://app.tryspecter.com/api/v1
security:
  - ApiKeyAuth: []
tags:
  - name: Enrich
    description: >
      Look up a company, person, or investor and, if Specter does not already
      hold it, fetch it on demand. Includes email-based person enrichment.
  - name: Search
    description: |
      Find records across every product from a single plain-English query.
  - name: Companies
    description: >
      Company profiles, funding, headcount, traction, the per-company signals
      and sub-resources attached to a single company, and identifier resolution.
  - name: People
    description: >
      Specter people records: profile data, contact details, and per-person
      lookups for a known person ID.
  - name: Investors
    description: >
      Specter investor records: profile, activity, targeting, funds, portfolio
      companies, and the funding rounds they have participated in.
  - name: Transactions
    description: |
      Transaction detail by ID: funding rounds, acquisitions, and IPOs.
  - name: News Signals
    description: |
      Company-level news signals: by ID, and for a saved list or company search.
  - name: Revenue Signals
    description: >
      Revenue and profitability signals: by ID, by date, and for a saved list or
      company search.
  - name: Talent Signals
    description: |
      Talent signals: by ID and in bulk by ID.
  - name: Investor Interest Signals
    description: |
      Investor interest signals: by ID and in bulk by ID.
  - name: Company Lists
    description: |
      Create, query, and maintain lists of companies, including their results.
  - name: Investor Lists
    description: |
      Create, query, and maintain lists of investors, including their results.
  - name: People Lists
    description: |
      Create, query, and maintain lists of people, including their results.
  - name: Saved Searches
    description: |
      List and delete searches saved via tryspecter.com.
  - name: Company Saved Searches
    description: |
      Details and results for saved company searches.
  - name: People Saved Searches
    description: |
      Details and results for saved people searches.
  - name: Investor Saved Searches
    description: |
      Details and results for saved investor searches.
  - name: Talent Signals Saved Searches
    description: |
      Details and results for saved Talent Signals searches.
  - name: Investor Interest Saved Searches
    description: |
      Details and results for saved Investor Interest Signals searches.
  - name: Network
    description: >
      Your team's LinkedIn network: the people and companies your teammates are
      connected to, and your reach into a given company.
  - name: Account
    description: >
      Organisation-level resources: your team's members, API call logs, and
      credit balance.
paths:
  /logs:
    get:
      tags:
        - Account
      summary: Get API call logs
      description: >
        Returns a paginated log of the API calls your organisation has made,
        newest first.


        <Note> Free. This call does not consume credits. </Note>


        ## What you need


        Nothing beyond your API key.


        ## Behaviour


        - Ordered newest first.

        - Page through with `page` and `limit`.

        - Filter by time window with `from` / `to` (ISO 8601 datetime, minute
        granularity).

        - The response carries an `X-Total-Count` header and RFC 5988 `Link`
        pagination links.

        - Each entry includes `credits_consumed` and `request_id`.


        ## What you do next


        - **Chase a specific call.** Quote a log entry's `request_id` when
        contacting API support to point them at that exact call.
      parameters:
        - $ref: '#/components/parameters/PaginationLimit'
        - $ref: '#/components/parameters/PaginationPage'
        - $ref: '#/components/parameters/LogsFromParam'
        - $ref: '#/components/parameters/LogsToParam'
      responses:
        '200':
          description: A paginated list of API log entries.
          headers:
            X-Total-Count:
              schema:
                type: integer
              description: Total number of log entries for the organization.
            Link:
              schema:
                type: string
              description: RFC 5988 pagination links (next, prev, first, last).
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - total
                properties:
                  items:
                    type: array
                    description: The log entries for this page.
                    items:
                      $ref: '#/components/schemas/ApiLogEntry'
                  total:
                    type: integer
                    description: Total number of log entries for the organization.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimits'
components:
  parameters:
    PaginationLimit:
      in: query
      name: limit
      schema:
        type: number
      required: false
      description: The number of results to return, default is 50.
    PaginationPage:
      in: query
      name: page
      schema:
        type: number
      required: false
      description: The page number of results to return, base 0, default is 0.
    LogsFromParam:
      in: query
      name: from
      schema:
        type: string
        format: date-time
      required: false
      description: >
        Filter logs at or after this datetime (ISO 8601, e.g.
        `2024-06-01T00:00:00Z`). Granularity up to the minute.
    LogsToParam:
      in: query
      name: to
      schema:
        type: string
        format: date-time
      required: false
      description: >
        Filter logs before or at this datetime (ISO 8601, e.g.
        `2024-06-30T23:59:00Z`). Granularity up to the minute.
  schemas:
    ApiLogEntry:
      type: object
      required:
        - timestamp
        - path
        - url
        - http_method
        - http_status
        - status
      properties:
        timestamp:
          type: string
          format: date-time
          description: UTC timestamp of the API call.
          example: '2026-07-17T16:04:52.227479Z'
        path:
          type: string
          description: Request path, e.g. '/v1/companies'.
          example: /api/v1/lists/people
        url:
          type: string
          description: Full request URL including query string.
          example: https://app.tryspecter.com/api/v1/lists/people
        http_method:
          type: string
          description: HTTP method used, e.g. 'GET' or 'POST'.
          example: GET
        http_status:
          type: integer
          description: HTTP status code returned by the API.
          example: 200
        status:
          type: string
          description: Logical status of the call, e.g. 'ok' or 'error'.
          example: SUCCESS
        query:
          type: object
          nullable: true
          description: Query parameters sent with the request, if any.
        credits_consumed:
          type: integer
          nullable: true
          description: Credits consumed by this API call, if known.
        request_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            UUID identifying this API call. Matches the `X-Request-ID` response
            header returned at the time of the call. Use it when contacting
            support to point at a specific call.
    ApiKeyMissing:
      properties:
        errorCode:
          description: API_KEY_MISSING
          example: API_KEY_MISSING
          type: string
        message:
          description: No API Key was presented on the header X-API-KEY
          example: No API Key was presented on the header X-API-KEY
          type: string
    ApiKeyNotValid:
      properties:
        errorCode:
          description: API_KEY_NOT_VALID
          example: API_KEY_NOT_VALID
          type: string
        message:
          description: API key present, but not valid
          example: API key present, but not valid
          type: string
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ApiKeyMissing'
              - $ref: '#/components/schemas/ApiKeyNotValid'
    RateLimits:
      description: Too Many Requests - API Rate limit exceeded
      content:
        application/json:
          schema:
            type: object
            required:
              - errorCode
              - message
            properties:
              errorCode:
                type: string
                description: RATE_LIMITED
              message:
                type: string
                description: You have been rate-limited
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: The total rate limit allowed for this endpoint
        X-RateLimit-Remaining:
          schema:
            type: integer
          description: The number of requests remaining
        X-RateLimit-Reset:
          schema:
            type: number
            format: float
          description: The number of seconds until the rate limit resets
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````