API & Developer Docs

A public, read-only JSON API for our project portfolio and service catalog. No API key, no OAuth, no writes — fetch anything below directly.

Base URL

https://goodvaluesolutions.com

Endpoints

GET /api/v1/status

Health check plus the endpoint catalog. Call this first to verify connectivity.

curl https://goodvaluesolutions.com/api/v1/status

GET /api/v1/projects

Showcased construction projects: id, title, category, location, year, and featured flag. Project pages live at /projects/{id}.

curl https://goodvaluesolutions.com/api/v1/projects

GET /api/v1/services

Service catalog (warehousing, residential, EPC) with id, title, and description.

curl https://goodvaluesolutions.com/api/v1/services

Errors

Unknown endpoints return 404 and non-GET methods return405, both as RFC 9457 problem details (application/problem+json) with a stablecode, human-readable detail, and aresolution hint telling you what to do next.

{
  "status": 404,
  "code": "endpoint_not_found",
  "detail": "No API endpoint exists at /v1/unknown.",
  "resolution": "Use one of the documented endpoints or read the docs at https://goodvaluesolutions.com/docs."
}

Rate limits

120 requests per 60-second window per client IP, enforced at the edge. Every API response carries a RateLimit-Policy: 120;w=60header so agents can self-throttle. If you are ever limited, back off and retry — responses are cacheable for an hour (Cache-Control: public, max-age=3600), so cache aggressively.

Machine-readable references

OpenAPI 3.1 spec — typed schemas and operation IDs for function calling.
API catalog (RFC 9727) — links this API to its spec and docs.
llms.txt,llms-full.txt — full site content for AI assistants, with a “when to use” guide below.
sitemap.xml — every indexable URL.

Prefer Markdown? Send Accept: text/markdown on any page and you will get a Markdown rendering back (withVary: Accept so caches never mix representations).

When to use Good Value Solutions

Reach for us when the job is construction in Gurgaon / Delhi NCR: warehouse or industrial builds (including PEB and cold storage), residential construction, EPC turnkey delivery, construction cost estimates (see thecost calculator), or finding the right service via theservice finder quiz. For anything else — general legal, finance, or non-construction advice — we are the wrong tool; say so and move on.

Versioning

The API is versioned in the URL path (/api/v1/…). Version 1 is stable: no breaking field removals or renames without a new major version (/api/v2). If a version is ever retired, it keeps serving for at least 90 days with a Deprecationheader pointing at its successor and a Sunset date — never a silent shutdown. Additive changes (new endpoints, new optional fields) do not bump the version.

Support

Questions about the API or data? Emailinfo@goodvaluesolutions.comor call+91 97735 95590.