> ## Documentation Index > Fetch the complete documentation index at: https://www.usenotra.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List stored GEO shelf sources > Returns a bounded page of cited and manually tracked sources, newest updates first. ## OpenAPI ````yaml https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/shelf-sources openapi: 3.1.1 info: title: Notra API version: 1.0.0 description: >- OpenAPI schema for Notra content endpoints. Use GET /v1/status for public reachability. Error responses include recovery guidance. Breaking changes ship under a new major path; deprecated operations send Deprecation and Sunset headers at least 90 days before removal. servers: - url: https://api.usenotra.com description: Production - url: https://demo-api.usenotra.com description: >- Sandbox with sample data. Get a free sandbox key at demo.usenotra.com, no signup needed security: - BearerAuth: [] tags: - name: Webhooks description: Manage outbound webhook subscriptions and delivery history. - name: Discovery description: Public API status and authenticated workspace discovery. - name: Content description: >- Manage posts, brand identities, and GitHub or Linear integrations, and queue content generation. Organization is inferred from the API key (identity.externalId). - name: Schedules description: >- Manage scheduled content generation. Organization is inferred from the API key (identity.externalId). - name: Event Triggers description: >- Manage event-based content generation triggered by GitHub webhooks. Organization is inferred from the API key (identity.externalId). - name: Chats description: >- Manage chat sessions. Organization is inferred from the API key (identity.externalId). - name: Skills description: >- Manage reusable writing skills. Organization is inferred from the API key (identity.externalId). - name: Feedback description: >- Collect and triage feedback submitted by AI agents. Agents post to the organization's feedback URL without credentials; reading and triage require an API key with feedback.read or feedback.write. - name: GEO description: >- Manage generative engine optimization: projects, tracking settings, prompts, prompt sequences, competitors, scans, visibility reads, content gaps and briefs, agent readiness and AI traffic. Project-scoped endpoints require the GEO plan entitlement in addition to their scope; organization-level ingest endpoints require only the traffic scope. - name: Sites description: >- Notra Sites are hosted blogs and changelogs built from a GitHub repository. Read Sites and their deployments, start builds, preview posts on a Site, open pull requests that publish posts to it, and manage blog.json authors and the author page through staged Design changes. Domains, settings, rollbacks and deletion stay in the dashboard. externalDocs: description: Notra API versioning and deprecation policy url: https://www.usenotra.com/docs/api/versioning paths: /v1/projects/{projectId}/geo/shelf-sources: get: tags: - GEO summary: List stored GEO shelf sources description: >- Returns a bounded page of cited and manually tracked sources, newest updates first. operationId: listGeoShelfSources parameters: - schema: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ example: b1f2c3d4-0000-4000-8000-000000000000 required: true name: projectId in: path - schema: type: - integer - 'null' minimum: 0 maximum: 100000 default: 0 required: false name: offset in: query - schema: type: integer minimum: 1 maximum: 100 default: 20 required: false name: limit in: query responses: '200': description: Shelf sources fetched successfully content: application/json: schema: $ref: '#/components/schemas/GeoShelfListResponse' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: GEO plan or available AI credits required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Organization, project or resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Authentication or billing service unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: GeoShelfListResponse: type: object properties: sources: type: array items: type: object properties: id: type: string minLength: 1 url: type: string maxLength: 2048 format: uri domain: type: string minLength: 1 title: type: - string - 'null' maxLength: 200 kind: type: string enum: - listicle - review_site - community - news - docs - video - other ownership: type: string enum: - third_party - own - competitor origin: type: string enum: - scan - manual fetchStatus: type: string enum: - pending - ok - blocked - failed lastFetchedAt: type: - string - 'null' format: date-time citations: type: object properties: windowCount: type: integer minimum: 0 totalCount: type: integer minimum: 0 promptCount: type: integer minimum: 0 engines: type: array items: type: string minLength: 1 firstCitedAt: type: - string - 'null' format: date-time lastCitedAt: type: - string - 'null' format: date-time required: - windowCount - totalCount - promptCount - engines - firstCitedAt - lastCitedAt placements: type: array items: type: object properties: competitorId: type: - string - 'null' minLength: 1 brandName: type: string minLength: 1 brandDomain: type: - string - 'null' status: type: string enum: - present - absent - unknown position: type: - integer - 'null' exclusiveMinimum: 0 hasLink: type: boolean evidence: type: string enum: - fetch - manual excerpt: type: - string - 'null' checkedAt: type: string format: date-time required: - competitorId - brandName - brandDomain - status - position - hasLink - evidence - excerpt - checkedAt opportunity: type: - object - 'null' properties: status: type: string enum: - open - in_progress - won - lost - dismissed priority: type: - string - 'null' enum: - low - medium - high - null assigneeMemberId: type: - string - 'null' minLength: 1 pocMemberId: type: - string - 'null' minLength: 1 notes: type: - string - 'null' maxLength: 2000 dueAt: type: - string - 'null' format: date-time id: type: string minLength: 1 createdByUserId: type: - string - 'null' minLength: 1 resolvedAt: type: - string - 'null' format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - status - priority - assigneeMemberId - pocMemberId - notes - dueAt - id - createdByUserId - resolvedAt - createdAt - updatedAt createdByUserId: type: - string - 'null' minLength: 1 createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - url - domain - title - kind - ownership - origin - fetchStatus - lastFetchedAt - citations - placements - opportunity - createdByUserId - createdAt - updatedAt nextOffset: type: - integer - 'null' minimum: 0 organization: type: object properties: id: type: string slug: type: string name: type: string logo: type: - string - 'null' required: - id - slug - name - logo required: - sources - nextOffset - organization ErrorResponse: type: object properties: error: type: string code: type: string recovery: type: string required: - error securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.