# University of Cambridge institution API

**Canonical:** https://apis.io/apis/university-of-cambridge/university-of-cambridge-institution-api/  
**Provider:** University of Cambridge — https://apis.io/providers/university-of-cambridge/  
**Base URL:** https://www.lookup.cam.ac.uk/api/v1/  
**Documentation:** https://www.lookup.cam.ac.uk/doc/ws-doc/

University of Cambridge institution API is one of 12 APIs that [University of Cambridge](https://apis.io/providers/university-of-cambridge/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include institution. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

Methods for querying and manipulating institutions. #### The fetch parameter for institutions All methods that return institutions also accept an optional `fetch` parameter that may be used to request additional information about the institutions returned. For more details about the general rules that apply to the `fetch` parameter, refer to the `PersonMethods` documentation. For institutions the `fetch` parameter may be used to fetch any institution attribute by specifying the `schemeid` of an institution attribute scheme. Examples include `"address"`, `"jpegPhoto"`, `"universityPhone"`, `"instPhone"`, `"landlinePhone"`, `"mobilePhone"`, `"faxNumber"`, `"email"` and `"labeledURI"`. The full list (which may be extended over time) may be obtained using `#allAttributeSchemes`. In addition the following pseudo-attributes are supported: * `"phone_numbers"` - fetches all phone numbers. This is equivalent to `"universityPhone,instPhone,landlinePhone,mobilePhone"`. * `"all_attrs"` - fetches all attributes from all institution attribute schemes. This does not include references. * `"contact_rows"` - fetches all institution contact rows. Any chained fetches from contact rows are used to fetch attributes from any people referred to by the contact rows. The `fetch` parameter may also be used to fetch referenced people, institutions or groups. This will only include references to non-cancelled entities. The following references are supported: * `"all_members"` - fetches all the people who are members of the institution. * `"parent_insts"` - fetches all the parent institutions. Note that currently all institutions have only one parent, but this may change in the future, and client applications should be prepared to handle multiple parents. * `"child_insts"` - fetches all the child institutions. * `"inst_groups"` - fetches all the groups that belong to the institution. * `"members_groups"` - fetches all the groups that form the institution's membership list. * `"managed_by_groups"` - fetches all the groups that manage the institution's data (commonly called "Editor" groups). As with person `fetch` parameters, the references may be used in a chain by using the "dot" notation to fetch additional information about referenced people, institutions or groups. For example `"all_members.email"` will fetch the email addresses of all members of the institution. For more information about what can be fetched from referenced people and groups, refer to the documentation for `PersonMethods` and `GroupMethods`.

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/openapi/university-of-cambridge-institution-api-openapi.yml
- **Documentation** — https://www.lookup.cam.ac.uk/doc/ws-doc/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/json-schema/university-of-cambridge-person-schema.json
- **x-json-structure** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/json-structure/university-of-cambridge-person-structure.json
- **x-examples** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/examples/university-of-cambridge-person-example.json
- **x-spectral-rules** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/rules/university-of-cambridge-rules.yml
- **x-vocabulary** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/vocabulary/university-of-cambridge-vocabulary.yml
- **x-json-ld-context** — https://raw.githubusercontent.com/api-evangelist/university-of-cambridge/refs/heads/main/json-ld/university-of-cambridge-context.jsonld

## Other University of Cambridge APIs (11)

- [Raven Authentication (OAuth2 / OpenID Connect)](https://apis.io/apis/university-of-cambridge/raven/)
- [Cambridge API Gateway (Card / Student / HR)](https://apis.io/apis/university-of-cambridge/gateway/)
- [Apollo Institutional Repository API (DSpace)](https://apis.io/apis/university-of-cambridge/apollo/)
- [University of Cambridge group API](https://apis.io/apis/university-of-cambridge/university-of-cambridge-group-api/)
- [University of Cambridge ibis API](https://apis.io/apis/university-of-cambridge/university-of-cambridge-ibis-api/)
- [University of Cambridge person API](https://apis.io/apis/university-of-cambridge/university-of-cambridge-person-api/)
- [Cambridge Shibboleth Identity Provider (SAML 2.0 metadata)](https://apis.io/apis/university-of-cambridge/shibboleth-idp/)
- [Apollo OAI-PMH metadata harvesting endpoint](https://apis.io/apis/university-of-cambridge/apollo-oai-pmh/)
- [Cambridge Digital Library IIIF APIs](https://apis.io/apis/university-of-cambridge/cudl-iiif/)
- [iDiscover library discovery (Ex Libris Primo VE) — TENANT](https://apis.io/apis/university-of-cambridge/idiscover-primo/)
- [Symplectic Elements research information system — TENANT](https://apis.io/apis/university-of-cambridge/elements-symplectic/)

## Tags

institution

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/university-of-cambridge/university-of-cambridge-institution-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/university-of-cambridge/.