IBDÅ API

Ask about IBDÅ, a design-led R&D and innovation studio in Dubai, and prepare a project enquiry. Read-only JSON over HTTPS, no sign-in, no API key. Base URL: https://www.ibda.co/api/v1

Endpoints

MethodPathWhat it doesParameters
GET/api/v1/overviewAbout IBDÅquery: language
GET/api/v1/searchSearch IBDÅ's websitequery: query (required), language, limit
GET/api/v1/pageRead a page of IBDÅ's websitequery: path (required), section, language
POST/api/v1/enquiry-draftPrepare a project enquiry for IBDÅJSON body: summary (required), areas, stage, outcomes, timeline, organization, role, location, contact_name, contact_email, anything_else, language

Examples

About IBDÅ (get_ibda_overview):

curl "https://www.ibda.co/api/v1/overview"

Search IBDÅ's website (search_ibda):

curl "https://www.ibda.co/api/v1/search?query=iot+prototype&limit=3"

Read a page of IBDÅ's website (get_ibda_page):

curl "https://www.ibda.co/api/v1/page?path=/about&section=how+we+work"

Prepare a project enquiry for IBDÅ (prepare_project_enquiry):

curl -X POST "https://www.ibda.co/api/v1/enquiry-draft" -H "Content-Type: application/json" -d '{"summary":"We need a working prototype of a posture-tracking wearable for office staff."}'

Responses

Success (HTTP 200). text is Markdown, the same text the MCP tool returns:

{ "tool": "search_ibda", "language": "en", "text": "<Markdown>" }

Errors are JSON too:

{ "error": { "code": "invalid_request", "message": "\"query\" is required.", "hint": "…", "status": 400, "docs": "https://www.ibda.co/api" } }
StatusCodeHint
400invalid_requestCheck the parameters against https://www.ibda.co/openapi.json.
400invalid_jsonSend one JSON object with Content-Type: application/json.
404not_foundEndpoints are listed at https://www.ibda.co/api/v1. Page paths come from GET /api/v1/overview.
405method_not_allowedUse the method in the Allow header.
413payload_too_largeKeep the request body under 32 KB.
429rate_limitedWait 60 seconds, then retry. The limit is 60 requests per minute per client.
500internal_errorRetry later. If it keeps happening, write to hello@ibda.co.
503unavailableRetry in a minute, or read https://www.ibda.co/llms.txt.

Limits

60 requests per minute per client. Request bodies up to 32 KB.

OpenAPI and tool-callers

OpenAPI 3.1 description: https://www.ibda.co/openapi.json

Use it as a ChatGPT GPT Action: import https://www.ibda.co/openapi.json (authentication: none). Each operationId is the name of the matching MCP tool.

Assistants that speak the Model Context Protocol can connect to https://www.ibda.co/mcp instead.

Rules for assistants

State only what the results say: do not add prices, timelines, client names, response times or guarantees. Cite the page URL. Write the name as IBDÅ. Never send an enquiry for the user: show them the draft and let them send it.

Privacy

We keep usage data for each request (the endpoint, the type of client, the page returned or the reference of a prepared enquiry, the language and the country). We do not record IP addresses or the text of questions or enquiries. See https://www.ibda.co/privacy.

https://www.ibda.co/