> ## Documentation Index > Fetch the complete documentation index at: https://docs.gpuoutlet.ai/llms.txt > Use this file to discover all available pages before exploring further. # Introductions your company is party to > `side` is required and never inferred: a company that both buys and sells must not find its purchases among its sales. Newest first, cursor-paginated. Requires `introductions:read`. ## OpenAPI ````yaml https://api.gpuoutlet.ai/v1/openapi.yaml get /introductions openapi: 3.1.0 info: title: GPU Outlet Partner API version: 2.0.0 description: > Programmatic access to the GPU Outlet introduction marketplace: state what capacity your company needs, read the opportunities offered to you, follow the introductions you are party to, and consult Radar. **Authentication.** Every endpoint except this document requires `Authorization: Bearer gpk_…`. Mint a key in your dashboard under Settings → API keys. The key is shown once, at creation, and is not recoverable — we store only its hash. **Company context.** A key belongs to a person; the company and the role the call acts with are that person's company membership, exactly as in the dashboard. A key whose owner is in no company gets `company_required`; a role short of the action gets `forbidden_role`. Nothing in a request body can name a company. **Scopes.** Each endpoint names the scope it needs. A key carries the scopes it was minted with and cannot grow one later; a key without the required scope gets `insufficient_scope` with `required_scope` in the error. **Idempotency.** Every `POST`, `PUT` and `PATCH` under Requests, Opportunities and Introductions **requires** `Idempotency-Key`. Generate one per intent (a UUID is fine) and reuse it verbatim on every retry of that same request: you get the original response back, marked `Idempotency-Replayed: true`, and nothing is written twice. The same key with a different body is `idempotency_key_reused`; a key whose first attempt is still running is `idempotency_key_in_flight` with `Retry-After`. Keys are remembered for 24 hours. Radar writes accept the header and echo it but do not require it. **Rate limits.** Every response carries `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset`; a 429 adds `Retry-After`. Writes have a smaller bucket of their own on top. Limits are enforced per API server instance and are approximate — treat `RateLimit-Remaining` as advisory, and back off on 429 rather than predicting it. **Compatibility.** We may add endpoints, add response fields, add optional query parameters, and add values to response enums at any time. Your client **must ignore fields it does not recognise.** Removing or renaming a field, changing a type, or tightening validation requires a new major version. **UI only.** The steps with legal effect stay in the dashboard, behind a second factor a key cannot present: accepting an opportunity and revealing the buyer, existing-relationship claims, deal reports and receipts, deal and success-fee invoices, and signing agreements. This API reads what those steps produced; it does not perform them. **What we do not publish.** Before a reveal, an opportunity carries the buyer's demand and nothing about the buyer — no name, no country, no id. Internal identifiers of people are never on the wire. Do not build on inferring either. servers: - url: https://api.gpuoutlet.ai/v1 security: - bearerAuth: [] tags: - name: Account description: Facts about the calling key. - name: Radar description: > Curated nodes of reserved capacity — what a signed-in buyer sees on the Radar page, and what a seller has proposed to it. - name: Requests description: > Your company's demand. A request is what the operator matches sellers against; sellers see an anonymised copy of it as an opportunity. - name: Opportunities description: > The seller's inbox — demand matched to your listing, anonymised until you accept it in the dashboard. Declining needs no second factor and is here. - name: Introductions description: > What both parties read after a reveal, and the one move either may make without a person present — "we are ready". paths: /introductions: get: tags: - Introductions summary: Introductions your company is party to description: > `side` is required and never inferred: a company that both buys and sells must not find its purchases among its sales. Newest first, cursor-paginated. Requires `introductions:read`. operationId: listIntroductions parameters: - name: side in: query required: true schema: type: string enum: - buyer - seller - $ref: '#/components/parameters/Cursor' - $ref: '#/components/parameters/Limit' responses: '200': description: One page of introductions content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/Introduction' meta: $ref: '#/components/schemas/PageMeta' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' components: parameters: Cursor: name: cursor in: query schema: type: string maxLength: 64 description: >- Opaque; from `meta.nextCursor`. Valid only for the list that produced it. Limit: name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 30 schemas: Introduction: type: object description: > The frozen record of a reveal. Both parties read the same row; `side` says which one you are. required: - id - reference - status - side - listingId - buyerRequestId - buyer - seller - buyerContacts - capacity - feeBasisPoints - agreement - revealedAt - tailEndsAt - claimDeadlineAt - closedAt - readiness properties: id: type: string reference: type: string description: Human-readable `GO-…` reference, quote it to support status: type: string enum: - active - released - expired - closed description: > `active` — the fee obligation stands. `released` — an existing relationship was proven, no fee is owed. `expired` — the tail ran out. `closed` — ended by the operator. side: type: string enum: - buyer - seller listingId: type: string buyerRequestId: type: string buyer: $ref: '#/components/schemas/Party' seller: $ref: '#/components/schemas/Party' buyerContacts: type: array description: Who the seller was given to make contact. items: type: object required: - email - role properties: email: type: string role: type: string capacity: type: object required: - demand - listing properties: demand: $ref: '#/components/schemas/Demand' listing: type: object required: - id - title - gpuModel - region properties: id: type: string title: type: - string - 'null' gpuModel: type: - string - 'null' region: type: - string - 'null' feeBasisPoints: type: integer agreement: type: object required: - version - hash properties: version: type: string hash: type: string revealedAt: type: string format: date-time tailEndsAt: type: string format: date-time claimDeadlineAt: type: string format: date-time closedAt: type: - string - 'null' format: date-time readiness: $ref: '#/components/schemas/Readiness' PageMeta: type: object required: - nextCursor properties: nextCursor: type: - string - 'null' description: > Pass back as `cursor` for the next page; `null` on the last page. There is no total count. Party: type: object required: - legalName - country properties: legalName: type: string country: type: string Demand: type: object description: >- The anonymised specification — a request without its author and without `notes`. required: - gpuModel - gpusPerNode - nodes - region - startsAt - endsAt - durationMonths - budgetMonthlyCents - currency properties: gpuModel: type: string gpusPerNode: type: integer nodes: type: integer region: type: string startsAt: type: string format: date-time endsAt: type: - string - 'null' format: date-time durationMonths: type: - integer - 'null' budgetMonthlyCents: type: - integer - 'null' currency: type: string enum: - USD - EUR Readiness: type: object required: - sellerReadyAt - buyerReadyAt properties: sellerReadyAt: type: - string - 'null' format: date-time buyerReadyAt: type: - string - 'null' format: date-time Error: type: object required: - error properties: error: type: object required: - type - code - message - doc_url - request_id properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - api_error code: type: string description: Stable machine-readable code message: type: string param: type: string description: The offending parameter, when applicable doc_url: type: string format: uri request_id: type: string description: >- Quote this when contacting support — it locates the exact request required_scope: type: string description: 'On `insufficient_scope`: the scope this endpoint needs' retry_after_seconds: type: integer description: >- On a rate-limit error or `idempotency_key_in_flight`: seconds to wait current: type: string description: > On `request_not_editable`, `opportunity_not_pending` and `introduction_not_active`: the status the resource is in. problems: type: array items: type: string description: >- On `request_invalid`: every field at fault (`gpu_model`, `term`, …) responses: BadRequest: description: >- `invalid_request` — a parameter was invalid (`param` names it) — or `idempotency_key_required` content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Missing, malformed, unknown, revoked or expired key content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: > The key is valid but not allowed to do this: `insufficient_scope` (with `required_scope`), `company_required`, `forbidden_role`, `api_keys_disabled`, or `banned`. content: application/json: schema: $ref: '#/components/schemas/Error' RateLimited: description: Rate limit or daily quota spent headers: Retry-After: schema: type: integer description: Seconds to wait before retrying content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: 'An API key from your dashboard, sent as `Authorization: Bearer gpk_…`.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.