Developer documentation

Learn how to connect to YDYL, authenticate requests, and query program and project data safely.

1. Concepts

Understand how YDYL models programs, projects, and assets.

  • Programs, projects, assets, and counterparts
  • Environments (sandbox, staging, production)
  • Data freshness and consistency guarantees

2. Authentication

Issue and rotate API keys for each environment and team.

  • Organization- and project-level keys
  • Scopes and roles
  • Rotation and revocation patterns

3. First request

Call the projects API and render a basic portfolio view.

  • Fetch programs and projects
  • Filter by geography, sector, or status
  • Paginate large result sets