# Pronouns.Page API

## Description
This is version `1.0.0` of this API documentation. Last update on Sep 18, 2025.
The Pronouns.Page API allows you to retrieve and manage pronoun data for users.

Most of the routes listed here are considered to be public as they do not require authentication.
However, some routes may require an API key for access to private or user-specific data.

In addition, some routes may take an optional `version` query parameter.
This parameter allows you to specify the version of the pronoun data you want to retrieve.
If not specified, version 1 will be used by default.

> info
> We highly recommend using version 2 as that will be are LTS version.
> We may remove version 1 entirely in the future.

## Routes
Routing standards may be altered in the future as well. We may make a `/v1/` or `/v2/` prefix to the routes.
Please check back here for the most up-to-date information.


## Servers
- Main (production) server: https://pronouns.page/api (Main (production) server)
- Language-specific server: https://en.pronouns.page/api (Language-specific server)




## Endpoints and operations

### [Pronouns](https://docs.api.pronouns.page/group/endpoint-pronouns.md)
- [Retrieve a list of pronouns](https://docs.api.pronouns.page/operation/operation-get-pronouns.md)
- [Retrieve a specific pronoun set](https://docs.api.pronouns.page/operation/operation-get-pronouns-parameter.md)
- [Retrieve a pronoun badge image](https://docs.api.pronouns.page/operation/operation-get-banner-parameter-png.md)
### [Users](https://docs.api.pronouns.page/group/endpoint-users.md)
- [Retrieve pronouns for a specific user](https://docs.api.pronouns.page/operation/operation-get-profile-get-parameter.md)
- [Retrieve pronouns for a specific user by ID](https://docs.api.pronouns.page/operation/operation-get-profile-get-id-parameter.md)
- [Retrieve pronouns for a user by social media identifier](https://docs.api.pronouns.page/operation/operation-get-user-social-lookup-parameter-parameter.md)
### [Sources](https://docs.api.pronouns.page/group/endpoint-sources.md)
- [Retrieve a list of pronoun data sources](https://docs.api.pronouns.page/operation/operation-get-sources.md)
- [Retrieve a specific pronoun data source](https://docs.api.pronouns.page/operation/operation-get-sources-parameter.md)
### [Dictionary](https://docs.api.pronouns.page/group/endpoint-dictionary.md)
- [Retrieve a list of gendered nouns](https://docs.api.pronouns.page/operation/operation-get-nouns.md)
- [Retrieve a specific gendered noun](https://docs.api.pronouns.page/operation/operation-get-nouns-search-parameter.md)
### [Inclusivity](https://docs.api.pronouns.page/group/endpoint-inclusivity.md)
- [Retrieve inclusivity features](https://docs.api.pronouns.page/operation/operation-get-inclusive.md)
- [Retrieve a specific inclusivity feature](https://docs.api.pronouns.page/operation/operation-get-inclusive-search-parameter.md)
### [Terminology](https://docs.api.pronouns.page/group/endpoint-terminology.md)
- [Retrieve a list of terminology definitions](https://docs.api.pronouns.page/operation/operation-get-terms.md)
- [Retrieve a specific terminology definition](https://docs.api.pronouns.page/operation/operation-get-terms-search-parameter.md)
### [Calendar](https://docs.api.pronouns.page/group/endpoint-calendar.md)
- [Retrieve today's pronoun-related events](https://docs.api.pronouns.page/operation/operation-get-calendar-today.md)
- [Retrieve pronoun-related events for a specific date](https://docs.api.pronouns.page/operation/operation-get-calendar-parameter.md)



[Powered by Bump.sh](https://bump.sh)