> ## Documentation Index > Fetch the complete documentation index at: https://docs.gravitygtm.com/llms.txt > Use this file to discover all available pages before exploring further. # Search for investors or LPs matching the stored profile > Requires a fundraising profile to already be set (PUT /v1/fundraising/profile first) -- returns 422 not_found otherwise. Searches VC funds and angels for a startup_equity profile, or family offices/HNW individuals/recently-exited founders/institutional allocators for a fund_lp profile. Set include_competitor_lookalikes to also surface funds that backed the profile's known_competitors. Costs 10-15 (by effort) credit(s) per call, charged even on a miss. ## OpenAPI ````yaml /helium/openapi.json post /v1/fundraising/search-investors openapi: 3.1.0 info: title: Helium API version: '1.0' description: >- Helium is a fundraising-research REST API sharing Horizon's prepaid-credit account system. Every request authenticates with an `Authorization: Bearer ` header (the same key that works against Horizon) and, on a billed endpoint, debits a fixed number of credits from your shared prepaid balance. Check your balance any time with GET /v1/usage (shared with Horizon). servers: - url: https://lite.gravitygtm.com/api security: - bearerAuth: [] paths: /v1/fundraising/search-investors: post: tags: - fundraising summary: Search for investors or LPs matching the stored profile description: >- Requires a fundraising profile to already be set (PUT /v1/fundraising/profile first) -- returns 422 not_found otherwise. Searches VC funds and angels for a startup_equity profile, or family offices/HNW individuals/recently-exited founders/institutional allocators for a fund_lp profile. Set include_competitor_lookalikes to also surface funds that backed the profile's known_competitors. Costs 10-15 (by effort) credit(s) per call, charged even on a miss. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SearchInvestorsRequest' responses: '200': description: >- 200 -- success. Charges 10-15 (by effort) credit(s) on this endpoint. cached is always false today -- no Helium endpoint is currently cached. content: application/json: schema: type: object properties: data: type: object properties: investors: type: array items: type: object properties: name: type: string sectorTags: type: array items: type: string geography: type: string lastActivityDate: type: string description: >- ISO date of most recent known investment/activity, if known. portfolioCompanies: type: array items: type: string lpType: type: string enum: - family_office - hnw_individual - recently_exited_founder - institutional - angel exitSizeUsd: type: number description: >- fund_lp side only -- the candidate's own exit size, if a recently-exited founder. networkProximity: type: number enum: - 0 - 1 description: >- 1 if a warm path was found via an imported network (see import_network). score: type: number tier: type: string enum: - A - B - C warmPath: type: boolean lookalikeVia: type: string description: >- Set when this candidate scored a boost for having backed a named competitor. rationale: type: string description: >- LLM-written 1-2 sentence fit rationale. Only present for the top-ranked candidates in a result set. conflict: type: boolean description: >- True if the rationale pass flagged a likely conflict (e.g. funded a direct competitor). additionalProperties: true additionalProperties: true description: Ranked list of scored investor/LP candidates. credits_charged: type: number description: 10-15 (by effort) credit(s), charged even on a miss. credits_remaining: type: number cached: type: boolean description: >- Always false today -- no Helium endpoint is currently cached. request_id: type: string format: uuid required: - data - credits_charged - credits_remaining - cached - request_id '401': description: >- 401 unauthorized -- missing or invalid `Authorization: Bearer ` header. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: >- 402 insufficient_credits -- not enough credit balance to cover this endpoint's price. The vendor is never called. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: >- 422 not_found -- the vendor was called successfully but returned no result. Still charged at full price. content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object properties: credits_charged: type: number description: >- Full listed price -- every Helium billed endpoint charges on a miss. '429': description: 429 rate_limited -- per-key fixed-window rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': description: >- 502 vendor_error -- the upstream vendor call failed or threw. Any reserved credits are refunded in full. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: >- 503 vendor_capacity -- this endpoint's vendor has hit its global daily spend cap. No credits are reserved; try again later. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: SearchInvestorsRequest: type: object properties: stage: type: string enum: - pre-seed - seed - series-a - series-b - series-c-plus sector_tags: type: array items: type: string minLength: 1 target_lp_types: type: array items: type: string enum: - family_office - hnw_individual - recently_exited_founder - institutional - angel geography: type: string minLength: 1 effort: type: string enum: - low - medium - high default: medium limit: type: integer minimum: 1 maximum: 50 default: 20 include_competitor_lookalikes: type: boolean default: false ErrorResponse: type: object description: >- Standard error body. Every response (success or error) carries a request_id for support reference. properties: error: type: string description: Machine-readable error code. enum: - unauthorized - insufficient_credits - not_found - rate_limited - vendor_error - vendor_capacity message: type: string description: Human-readable error detail. request_id: type: string format: uuid credits_remaining: type: number description: >- Present whenever a post-reservation/refund balance is known for this request. refund_issue: type: boolean description: >- Set only when a compensating credit refund itself failed (e.g. a transient store error) -- the customer may have been charged without the refund landing yet. required: - error - message - request_id securitySchemes: bearerAuth: type: http scheme: bearer ````