The examples below illustrate possible request, response, and data-schema patterns. They do not confirm that a specific endpoint, field, rate limit, or integration is currently available. Eyecosystems delivers data through API and MCP options. Request technical documentation for current details.
01
Getting Started
Eyecosystems delivers structured accessibility community data through plug-and-play API and MCP integrations. Human-in-the-loop review and provenance add context to records. The examples on this page are illustrative; confirm current endpoints, fields, authentication, and access details with our team.
For current access options and technical documentation, request technical documentation.
All requests must be made over HTTPS. HTTP requests will be rejected. All responses use UTF-8 encoding.
02
Authentication
Authenticate by passing your API key in the Authorization header as a Bearer token. All requests require a valid API key.
Authorization: Bearer YOUR_API_KEY
curl https://api.eyecosystems.com/v1/records \ -H "Authorization: Bearer YOUR_API_KEY"
To obtain an API key, contact the Eyecosystems team. Keys are issued per subscriber and should be kept confidential. Do not expose your key in client-side code.
03
Endpoints
All endpoints return JSON. Paginated list responses include total, limit, offset, and data fields.
Illustrative pattern for listing records with city, state, and type filters and paginated results. Confirm current endpoint behavior with the Eyecosystems team.
| Parameter | Type | Description |
|---|---|---|
| city | string | Filter by city name (e.g. Jacksonville) |
| state | string | Filter by two-letter state code (e.g. FL) |
| type | string | Filter by organization type (e.g. nonprofit_advocacy) |
| limit | integer | Number of results per page. Default: 25. Max: 100 |
| offset | integer | Pagination offset. Default: 0 |
curl "https://api.eyecosystems.com/v1/records?city=Jacksonville&state=FL&limit=10" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"total": 1,
"limit": 10,
"offset": 0,
"data": [
{
"eyeco_id": "jax-0001",
"name": "Jacksonville Community Resource",
"type": "nonprofit_community",
"verified_at": "2026-04-08T14:32:00Z",
"verifier": "human_reviewer",
"city": "Jacksonville",
"state": "FL",
"contact_verified": true,
"tags": ["community", "blind-and-low-vision", "community-resource"],
"verification_method": "human_eye_spy_network",
"provenance_hash": "sha256:e3b0c44...",
}
]
}
Illustrative pattern for retrieving a record by its eyeco_id. Confirm current endpoint behavior and available fields with the Eyecosystems team.
curl "https://api.eyecosystems.com/v1/records/jax-0042" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"eyeco_id": "jax-0042",
"name": "Florida Council of the Blind: Jacksonville Chapter",
"type": "nonprofit_advocacy",
"verified_at": "2026-04-08T14:32:00Z",
"verifier": "human_reviewer",
"city": "Jacksonville",
"state": "FL",
"contact_verified": true,
"tags": ["advocacy", "peer-support", "community-resource"],
"updated_at": "2026-04-08T14:32:00Z",
"verification_method": "human_eye_spy_network",
"provenance_hash": "sha256:e3b0c44..."
}
Full-text search across record names, tags, and descriptions. Returns ranked results matching the query.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query string (required) |
| city | string | Optionally scope results to a city |
| state | string | Optionally scope results to a state |
| limit | integer | Results per page. Default: 25 |
| offset | integer | Pagination offset. Default: 0 |
curl "https://api.eyecosystems.com/v1/records/search?q=peer+support&state=FL" \ -H "Authorization: Bearer YOUR_API_KEY"
04
Data Schema
Record structure depends on current data availability. The fields below are illustrative; request technical documentation for confirmed fields and access details.
| Field | Type | Description |
|---|---|---|
| eyeco_id | string | Unique Eyecosystems record identifier. Format: {city_code}-{sequence} |
| name | string | Full verified name of the organization, service, or resource |
| type | string | Organization type. Values: nonprofit_advocacy, nonprofit_community, government_service, assistive_tech, education, peer_support, event |
| verified_at | ISO 8601 datetime | Timestamp of the most recent human verification |
| verifier | string | Verification method identifier. Currently always human_bvi_reviewer |
| city | string | City of the organization's primary location |
| state | string | Two-letter US state code |
| contact_verified | boolean | true if contact information has been verified in this verification cycle |
| tags | array of strings | Taxonomy tags for filtering and discovery. Examples: advocacy, peer-support, community-resource |
| updated_at | ISO 8601 datetime | Timestamp of the last record update (any field change) |
| provenance | string | Describes the source and review history associated with a record |
| verification_method | string | The human-in-the-loop review method associated with a record, when available |
| provenance_hash | string | Provenance details that describe the source and review history of a record |
05
Rate Limits
Rate limits are enforced per API key. Exceeding the limit returns a 429 Too Many Requests response. The Retry-After header indicates when you may retry.
Current access limits and response details are provided with technical documentation.
06
Support
Contact us with questions about data access, available fields, or integration options.
Email: contact@eyecosystems.com
For partnership or Enterprise inquiries, use the contact form and select "Data Access" as the purpose.
Request a trial API key, sample data set, and current technical documentation from the Eyecosystems team.