Symphos architectural iconA minimal architectural symbol with three vertical pillars and a tapered lintel.SYMPHOS

    API Reference

    Programmatic access to Symphos's analysis capabilities.

    API Access Available

    API access is included with your subscription (Solo Founder or Analyst/Mentor). Generate and manage your API keys from the Settings page.

    Authentication

    All API requests must include your API key in the Authorization header:

    Authorization: Bearer sym_your_api_key_here

    API keys start with sym_ and are only shown once when created. Store them securely.

    Base URL

    https://symphos.xyz/api/v1

    Endpoints

    Projects

    GET/v1/projectsList all your projects
    GET/v1/projects/:idGet project details
    POST/v1/projectsCreate a new project
    PATCH/v1/projects/:idUpdate a project
    DELETE/v1/projects/:idDelete a project

    Lenses

    GET/v1/lensesList your lenses
    GET/v1/lenses/:idGet lens details
    POST/v1/lensesCreate a custom lens

    Evaluations

    POST/v1/projects/:id/evaluateRun project through a lens
    GET/v1/evaluations/:idGet evaluation results

    Analysis

    POST/v1/projects/:id/analyzeRun general analysis
    POST/v1/projects/:id/find-fundersFind aligned capital sources

    Capital

    GET/v1/fundersSearch capital database
    GET/v1/funders/:idGet capital source details

    Example Request

    # List your projects

    curl -X GET https://symphos.xyz/api/v1/projects \-H "Authorization: Bearer sym_your_api_key"

    Rate Limits

    API access is subject to the following rate limits:

    Subscribed100 requests/minute

    Rate limit headers are included in all API responses.

    Error Responses

    All errors return a JSON response with error and message fields:

    { "error": "Invalid API key", "message": "The provided API key is invalid or has been revoked" }
    401Unauthorized - Invalid or missing API key
    403Forbidden - Subscription required or expired
    404Not Found - Resource doesn't exist
    429Too Many Requests - Rate limit exceeded

    Need Help?

    Questions about the API? Contact us and we'll be happy to help.