> ## Documentation Index > Fetch the complete documentation index at: https://partners.ladder.africa/llms.txt > Use this file to discover all available pages before exploring further. # Get an investment ## OpenAPI ````yaml /openapi.json get /partner/v1/investments/{investment_id} openapi: 3.0.3 info: title: Ladder Partner API version: v1 description: >- Server-to-server API for licensed partner organisations: KYB, NGN/GHS/USD wallets, funding rails, investments and NGX market data, buy and sell orders, holdings and webhooks. Every request is HMAC-signed; see the Authentication guide. contact: email: partners@myladder.africa servers: - url: https://api.myladder.africa description: Production - url: https://api-dev.myladder.africa description: UAT (integration and acceptance testing) security: - LadderKey: [] LadderTimestamp: [] LadderSignature: [] tags: - name: Organisation description: The calling organisation and what KYB still needs. - name: KYB description: >- Business information, people, documents, settlement accounts and submission. - name: Wallets description: >- Balances, funding requests on every rail, direct-debit mandates and the ledger statement. - name: Investments description: What a partner can buy. - name: Market data description: >- Nigerian Exchange instruments, quotes, bars, indices, FX, calendar and disclosures. - name: Orders description: Buy and sell orders and their lifecycle. - name: Holdings description: Positions created by completed buys. - name: Webhooks description: Endpoints, deliveries and retries. - name: Sandbox description: Test-key only helpers. paths: /partner/v1/investments/{investment_id}: parameters: - name: investment_id in: path required: true schema: type: string get: tags: - Investments summary: Get an investment operationId: investments_read parameters: [] responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PartnerInvestmentResponse' '400': description: Validation or business-rule error (see `error.code`). content: application/json: schema: $ref: '#/components/schemas/PartnerError' '401': description: Missing/invalid signature, stale timestamp, unknown or revoked key. content: application/json: schema: $ref: '#/components/schemas/PartnerError' '403': description: IP not allowlisted, or action not allowed for this key/environment. content: application/json: schema: $ref: '#/components/schemas/PartnerError' '404': description: Not found (or belongs to another organisation/environment). content: application/json: schema: $ref: '#/components/schemas/PartnerError' '429': description: Rate limited (120 requests/min per key). See `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/PartnerError' components: schemas: PartnerInvestmentResponse: required: - data type: object properties: data: $ref: '#/components/schemas/PartnerInvestment' PartnerError: required: - error type: object properties: error: $ref: '#/components/schemas/PartnerErrorBody' PartnerInvestment: required: - name type: object properties: id: title: Id type: string format: uuid readOnly: true name: title: Name type: string maxLength: 100 minLength: 1 description: title: Description type: string minLength: 1 nullable: true category: title: Category type: string readOnly: true minLength: 1 provider: title: Provider type: string maxLength: 100 minLength: 1 nullable: true country: title: Country type: string enum: - GH - NG nullable: true currency: title: Currency type: string enum: - GHS - USD - NGN nullable: true price: title: Price type: string format: decimal readOnly: true bid_price: title: Bid price type: string format: decimal nullable: true minimum_investment: title: Minimum investment type: string format: decimal readOnly: true expected_return_rate: title: Expected return rate type: string format: decimal readOnly: true duration: title: Duration type: string enum: - 60 days - 90 days - 180 days - 3 months - 6 months - 4 months - 9 months - 12 months nullable: true payout_type: title: Payout type type: string enum: - regular earnings on investments - capital + profit paid at maturity date - profit shared with shareholders nullable: true risk_profile: title: Risk profile type: string maxLength: 50 minLength: 1 nullable: true start_date: title: Start date type: string format: date nullable: true close_date: title: Close date type: string format: date nullable: true maturity_date: title: Maturity date type: string format: date nullable: true status: title: Status type: string enum: - pending - completed - failed - order_matched - funds_sent - lp_acknowledges_funds - dispute - pending_allotment - success - timed out - active - paused - stopped - matured - moved_to_flex_dollar - in_progress - withdrawal_in_progress - closed - archived - available - target_met - ongoing - cancelled - goal_reached - unpaid - paid - ready_for_deletion - rejected - expired - executed - submitted - partially_filled - migrated - chose_to_not_migrate - merged nullable: true is_open: title: Is open type: string readOnly: true allocation_remaining: title: Allocation remaining type: string readOnly: true terms_url: title: Terms url type: string format: uri readOnly: true minLength: 1 image_url: title: Image url type: string format: uri readOnly: true minLength: 1 PartnerErrorBody: required: - code - message - details type: object properties: code: title: Code description: Stable machine-readable code, e.g. `insufficient_funds`. type: string minLength: 1 message: title: Message type: string minLength: 1 details: title: Details description: Code-specific context (validation errors, balances, …). type: object additionalProperties: type: string nullable: true securitySchemes: LadderKey: type: apiKey in: header name: X-Ladder-Key description: 'Your key id: `pk_test_…` (sandbox) or `pk_live_…` (live).' LadderTimestamp: type: apiKey in: header name: X-Ladder-Timestamp description: Unix seconds, as a string; must be within 5 minutes of server time. LadderSignature: type: apiKey in: header name: X-Ladder-Signature description: >- Lower-case hex HMAC-SHA512 over timestamp, method, path+query and the SHA-256 of the body. See Authentication. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.