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

# Get Request Logs

> Fetch gateway-captured HTTP request logs for an app.

Source of truth for what requests hit the public URL, independent of the
app's own access log. Emits one entry per request proxied or rejected by
floo's gateway. Always shows the public URL the caller actually used.



## OpenAPI

````yaml https://api.getfloo.com/openapi.json get /v1/apps/{app_id}/requests
openapi: 3.1.0
info:
  title: floo API
  version: 0.1.0
servers:
  - url: https://api.getfloo.com
security: []
paths:
  /v1/apps/{app_id}/requests:
    get:
      tags:
        - requests
      summary: Get Request Logs
      description: |-
        Fetch gateway-captured HTTP request logs for an app.

        Source of truth for what requests hit the public URL, independent of the
        app's own access log. Emits one entry per request proxied or rejected by
        floo's gateway. Always shows the public URL the caller actually used.
      operationId: requests_get_request_logs
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: App Id
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            default: 100
            title: Limit
        - name: since
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Duration (e.g. '1h', '30m', '2d') or ISO 8601 timestamp
            title: Since
          description: Duration (e.g. '1h', '30m', '2d') or ISO 8601 timestamp
        - name: method
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter to a specific HTTP method (GET, POST, etc.)
            title: Method
          description: Filter to a specific HTTP method (GET, POST, etc.)
        - name: status_class
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 5
                minimum: 1
              - type: 'null'
            description: 'Filter by status-code class: 2=2xx, 3=3xx, 4=4xx, 5=5xx'
            title: Status Class
          description: 'Filter by status-code class: 2=2xx, 3=3xx, 4=4xx, 5=5xx'
        - name: host
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter requests to a specific public hostname
            title: Host
          description: Filter requests to a specific public hostname
        - name: api_key_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: Filter by app API key ID, never the raw key
            title: Api Key Id
          description: Filter by app API key ID, never the raw key
        - name: until
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Exclusive end of the time range (ISO 8601)
            title: Until
          description: Exclusive end of the time range (ISO 8601)
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: next_cursor from the preceding page
            title: Cursor
          description: next_cursor from the preceding page
        - $ref: '#/components/parameters/X-Floo-Org-Id'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestLogsResponse'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    X-Floo-Org-Id:
      name: X-Floo-Org-Id
      in: header
      required: false
      schema:
        type: string
        format: uuid
      description: Organization to act in; defaults to the one joined most recently.
  schemas:
    RequestLogsResponse:
      properties:
        requests:
          items:
            $ref: '#/components/schemas/RequestLogEntry'
          type: array
          title: Requests
        total:
          type: integer
          title: Total
        app_name:
          type: string
          title: App Name
        next_cursor:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Next Cursor
      type: object
      required:
        - requests
        - total
        - app_name
      title: RequestLogsResponse
      description: Response for the gateway request logs endpoint.
    ErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - detail
      title: ErrorResponse
      description: Body of every error response except request validation (422).
    RequestLogEntry:
      properties:
        timestamp:
          type: string
          title: Timestamp
        method:
          type: string
          title: Method
        path:
          anyOf:
            - type: string
            - type: 'null'
          title: Path
        host:
          anyOf:
            - type: string
            - type: 'null'
          title: Host
        status_code:
          type: integer
          title: Status Code
        latency_ms:
          type: integer
          title: Latency Ms
        access_mode:
          type: string
          title: Access Mode
        user_identity:
          anyOf:
            - type: string
            - type: 'null'
          title: User Identity
        app_consumer_api_key_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: App Consumer Api Key Id
      type: object
      required:
        - timestamp
        - method
        - status_code
        - latency_ms
        - access_mode
      title: RequestLogEntry
      description: A single HTTP request handled by floo's gateway.
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      additionalProperties: true
      type: object
      required:
        - code
        - message
      title: ErrorDetail
      description: Standard error envelope with operation-specific JSON context.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A `floo_` API key.

````

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