> ## Documentation Index > Fetch the complete documentation index at: https://docs.augment.market/llms.txt > Use this file to discover all available pages before exploring further. # Get an offering > Returns a single offering by its public identifier ## OpenAPI ````yaml /openapi.generated.json get /api/v1/offerings/{offering_id} openapi: 3.0.3 info: title: Augment External API version: 1.0.0 description: > Public, API-key-authenticated read surface for Augment company and offering data. servers: - url: https://developer.augment.market - url: https://xxe4toqf29.execute-api.us-west-2.amazonaws.com/dev-ethan security: [] paths: /api/v1/offerings/{offering_id}: get: tags: - external-api-v1 summary: Get an offering description: Returns a single offering by its public identifier operationId: getExternalApiOffering parameters: - name: offering_id in: path description: The public identifier of the offering required: true schema: type: string responses: '200': description: The requested offering content: application/json: schema: $ref: '#/components/schemas/Offering' example: public_id: off_9f8c2a company_id: 42 description: Acme Robotics Series C secondary status: OPEN type: COMMITTED acquisition_method: SECONDARY management_fee: 2% carry: 20% investment_structure: SPV estimated_valuation: '1200000000' minimum_commitment_amount: 25000 created_at: '2025-01-01T00:00:00Z' updated_at: '2025-01-15T12:00:00Z' '400': $ref: '#/components/responses/ErrorBadRequest' '401': $ref: '#/components/responses/ErrorUnauthorized' '403': $ref: '#/components/responses/ErrorForbidden' '404': $ref: '#/components/responses/ErrorNotFound' '429': $ref: '#/components/responses/ErrorRateLimited' '500': $ref: '#/components/responses/ErrorInternalError' '503': $ref: '#/components/responses/ErrorServiceUnavailable' security: - ApiKeyAuth: [] components: schemas: Offering: type: object properties: public_id: type: string description: Public identifier of the offering company_id: type: integer description: Identifier of the company the offering is for description: type: string description: Description of the offering status: $ref: '#/components/schemas/OfferingStatus' type: $ref: '#/components/schemas/OfferingType' acquisition_method: $ref: '#/components/schemas/OfferingAcquisitionMethod' management_fee: type: string description: Management fee charged on the investment carry: type: string description: Carried interest charged on the investment investment_structure: type: string description: How the investment is structured estimated_valuation: type: string description: Estimated valuation the offering is priced against minimum_commitment_amount: type: number format: double description: Smallest commitment an investor may make closed_at: type: string format: date-time nullable: true description: When the offering closed, if it has closed created_at: type: string format: date-time description: When the offering was created updated_at: type: string format: date-time description: When the offering was last updated required: - public_id - company_id - description - status - type - acquisition_method - management_fee - carry - investment_structure - estimated_valuation - minimum_commitment_amount - created_at - updated_at additionalProperties: false OfferingStatus: type: string description: Lifecycle status of an offering enum: - COMING - OPEN - CLOSING - CLOSED - CANCELLED - ROFRED OfferingType: type: string description: How the offering is structured for investors enum: - WAREHOUSED - COMMITTED - OPPORTUNITY OfferingAcquisitionMethod: type: string description: Market the underlying shares are acquired through enum: - PRIMARY - SECONDARY ErrorEnvelope: type: object description: Error body returned by every failing response properties: error: type: string description: Human-readable error message code: $ref: '#/components/schemas/ErrorCode' required: - error - code additionalProperties: false ErrorCode: type: string description: > Machine-readable error code. Mirrors external/domain/errors.go exactly; the wire strings are part of the public contract and must not drift from that file. enum: - unauthenticated - invalid_key - key_revoked - insufficient_scope - client_suspended - not_found - invalid_parameter - rate_limited - service_unavailable - internal_error responses: ErrorBadRequest: description: Invalid request parameter content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Invalid request parameter code: invalid_parameter ErrorUnauthorized: description: Missing, invalid, or revoked API credentials content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Missing API credentials code: unauthenticated ErrorForbidden: description: The API key lacks the required scope, or the client is suspended content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: API key does not grant the required scope code: insufficient_scope ErrorNotFound: description: The requested resource does not exist content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Resource not found code: not_found ErrorRateLimited: description: Too many requests content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Too many requests, please try again later code: rate_limited ErrorInternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Internal server error code: internal_error ErrorServiceUnavailable: description: The service is temporarily unavailable; retry later content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: Service temporarily unavailable, please try again later code: service_unavailable securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: > The API key issued to your client. Send it on every request; a missing, unrecognised, or revoked key is rejected with 401. ````