> ## Documentation Index > Fetch the complete documentation index at: https://docs.trackup.me/llms.txt > Use this file to discover all available pages before exploring further. # List project requests > Requires request.list. Returns paginated requests with attribution, inspection results and nullable customData. ## OpenAPI ````yaml https://api.trackup.me/openapi.json get /v1/projects/{id}/requests openapi: 3.1.0 info: title: Trackup API description: >- API-key-accessible Trackup operations. Send your key in the `X-Api-Key` header. Keys belong to a team. `X-Team-Id` is not required; if supplied, it must match that team. Each operation lists its required key permission. The key creator must remain a team member and normally hold that permission. The ingest-only permissions `visitor.create`, `conversion.create`, and `request.create` do not need to be held by the creator. Project access and selection are described per operation. Session-only account, administration and OAuth operations are not part of this reference. The same operations are available as MCP tools at `/mcp` (Streamable HTTP). Authenticate with `X-Api-Key` or connect through OAuth, which issues an API key on consent. Schema validation errors return HTTP 422 with an `errors` object. Other errors generally contain `error` and `message`; operation-specific responses describe exceptions. version: 1.0.0 servers: - url: / description: Current API environment security: - ApiKey: [] paths: /v1/projects/{id}/requests: get: tags: - Requests summary: List project requests description: >- Requires request.list. Returns paginated requests with attribution, inspection results and nullable customData. operationId: listProjectRequests parameters: - in: path name: id schema: type: string format: uuid required: true - in: query name: startDate schema: type: string minLength: 1 - in: query name: endDate schema: type: string minLength: 1 - in: query name: page schema: type: integer minimum: 1 default: 1 - in: query name: limit schema: type: integer minimum: 1 maximum: 100 default: 50 - in: query name: filters schema: type: string responses: '200': description: Successful response. content: application/json: schema: $ref: '#/components/schemas/RequestList' '401': description: The X-Api-Key header is missing or the API key is invalid. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: >- The key is expired, revoked, lacks permission, or its creator no longer has the required team access. A conflicting X-Team-Id is also rejected. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: >- The requested resource was not found or is outside the permitted scope. content: application/json: schema: $ref: '#/components/schemas/ApiError' '422': description: >- Invalid input. Each field path maps to its first validation message; _form identifies an object-level error. content: application/json: schema: $ref: '#/components/schemas/ValidationError' '500': description: An unexpected error occurred. content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: RequestList: type: object properties: data: type: array items: $ref: '#/components/schemas/Request' count: type: number required: - data - count example: data: - id: 11111111-1111-4111-8111-111111111111 timestamp: '2026-06-01 12:00:00.000' host: track.example.test path: /offer event: pageview ip: 192.0.2.10 ipHash: '' userAgent: Example/1.0 referer: '' country: BR city: São Paulo region: '' lat: null lon: null proxy: false isp: '' timezone: '' browserLanguage: '' visitorId: visitor-example-1 browser: '' browserVersion: '' os: '' osVersion: '' device: '' deviceVendor: '' deviceModel: '' isReturningVisitor: false hasPassedChallenge: false score: 1 scoreLevel: low bot: false decision: allow reasons: [] firewallRuleId: '' firewallRuleName: '' utmSource: newsletter utmMedium: email utmCampaign: example-campaign utmTerm: '' utmContent: '' clickId: '' trafficSource: newsletter sub1: '' sub2: '' sub3: '' sub4: '' sub5: '' sub6: '' sub7: '' sub8: '' customData: null count: 1 ApiError: type: object properties: error: type: string message: type: string required: - error - message additionalProperties: true ValidationError: type: object properties: errors: type: object additionalProperties: type: string required: - errors Request: type: object properties: id: type: string timestamp: type: string description: ClickHouse UTC timestamp. host: type: string path: type: string event: type: string ip: type: string ipHash: type: string userAgent: type: string referer: type: string country: type: string city: type: string region: type: string lat: type: - number - 'null' lon: type: - number - 'null' proxy: type: boolean isp: type: string timezone: type: string browserLanguage: type: string visitorId: type: string browser: type: string browserVersion: type: string os: type: string osVersion: type: string device: type: string deviceVendor: type: string deviceModel: type: string isReturningVisitor: type: boolean hasPassedChallenge: type: boolean score: type: number scoreLevel: type: string bot: type: boolean decision: type: string reasons: type: array items: type: string firewallRuleId: type: string firewallRuleName: type: string utmSource: type: string utmMedium: type: string utmCampaign: type: string utmTerm: type: string utmContent: type: string clickId: type: string trafficSource: type: string sub1: type: string sub2: type: string sub3: type: string sub4: type: string sub5: type: string sub6: type: string sub7: type: string sub8: type: string customData: type: - object - 'null' additionalProperties: {} required: - id - timestamp - host - path - event - ip - ipHash - userAgent - referer - country - city - region - lat - lon - proxy - isp - timezone - browserLanguage - visitorId - browser - browserVersion - os - osVersion - device - deviceVendor - deviceModel - isReturningVisitor - hasPassedChallenge - score - scoreLevel - bot - decision - reasons - firewallRuleId - firewallRuleName - utmSource - utmMedium - utmCampaign - utmTerm - utmContent - clickId - trafficSource - sub1 - sub2 - sub3 - sub4 - sub5 - sub6 - sub7 - sub8 - customData example: id: 11111111-1111-4111-8111-111111111111 timestamp: '2026-06-01 12:00:00.000' host: track.example.test path: /offer event: pageview ip: 192.0.2.10 ipHash: '' userAgent: Example/1.0 referer: '' country: BR city: São Paulo region: '' lat: null lon: null proxy: false isp: '' timezone: '' browserLanguage: '' visitorId: visitor-example-1 browser: '' browserVersion: '' os: '' osVersion: '' device: '' deviceVendor: '' deviceModel: '' isReturningVisitor: false hasPassedChallenge: false score: 1 scoreLevel: low bot: false decision: allow reasons: [] firewallRuleId: '' firewallRuleName: '' utmSource: newsletter utmMedium: email utmCampaign: example-campaign utmTerm: '' utmContent: '' clickId: '' trafficSource: newsletter sub1: '' sub2: '' sub3: '' sub4: '' sub5: '' sub6: '' sub7: '' sub8: '' customData: null securitySchemes: ApiKey: type: apiKey in: header name: X-Api-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.