Reading data from the API

The OpenRiC reference API is at https://ric.theahg.co.za/api/ric/v1. Reads are public; every response is application/ld+json.

List and fetch

# List records (paginated)
curl -s "https://ric.theahg.co.za/api/ric/v1/records?limit=20"

# One record by slug
curl -s "https://ric.theahg.co.za/api/ric/v1/records/kc4x-45tz-em84"

# The same shape for agents, places, activities, instantiations, rules, functions, repositories
curl -s "https://ric.theahg.co.za/api/ric/v1/agents"

A single entity comes back as RiC-O JSON-LD:

{
  "@context": "https://openric.org/ns/ext/v1#",
  "@id": "https://ric.theahg.co.za/ric/record/kc4x-45tz-em84",
  "@type": "rico:Record",
  "rico:title": "Field recording - Reel 12",
  "rico:hasOrHadHolder": { "@id": "...", "@type": "rico:CorporateBody" }
}

The @type reflects the level - rico:Record, rico:RecordSet, or rico:RecordPart.

Search & autocomplete

curl -s "https://ric.theahg.co.za/api/ric/v1/autocomplete?q=egypt&limit=5"

Returns a flat list of {id, label, type} across all entity types.

Walk the graph

# Neighbourhood of an entity, to a depth
curl -s "https://ric.theahg.co.za/api/ric/v1/graph?uri=<entity-iri>&depth=1"
# Relations of one entity
curl -s "https://ric.theahg.co.za/api/ric/v1/relations-for/912150"
# Hierarchy (parent/children/siblings)
curl -s "https://ric.theahg.co.za/api/ric/v1/hierarchy/912150"

Pagination

List endpoints accept ?page= and ?limit= (max 200). The response carries ric:total / ric:page / ric:limit.

Errors

Errors use RFC 7807 problem+json:

{ "type": "https://openric.org/errors/not-found", "title": "Not Found", "status": 404, "detail": "..." }

The whole surface

GET /api/ric/v1/ returns the service description (name, version, declared profiles); GET /api/ric/v1/openapi.json is the OpenAPI 3.0 contract; GET /api/ric/v1/docs is a live Swagger UI you can “try it out” in.

Next

• Creating data - write entities
• SPARQL queries · Export & harvesting