The Dozens - The Yo Momma Joke
## Yo' Momma — The Dozens Joke API The Dozens is a RESTful (and GraphQL) API that delivers a curated, community-contributed library of "Yo' Momma" style insults and jokes. Whether you're building a gag app, a Discord bot, a party game, or just need a quick laugh on demand, The Dozens gives you structured, filterable access to hundreds of categorized burns. --- ### What You Can Do | Action | Auth…
2 subscribers
87 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
The Dozens - The Yo Momma Joke endpoints
| Method | Endpoint | Description |
|---|---|---|
| Insults | ||
| GET |
Get A Random Insult /api/insults/random/ |
Returns a single random insult from the active collection. Supports optional filtering by NSFW status and category for more targeted results. |
| GET |
Retrieve A Specific Insult /api/insults/{reference_id}/ |
Retrieve a specific insult by reference_id. |
| POST |
Create An Insult (Must Be Registered) /api/insults/new |
# Create New Insult (Must Be Registered User) Creates new insults owned by authenticated users. New insults default to 'Pending' status pending approval. ## Endpoints: POST… |
| PATCH |
Partially Update An Insult (Must Be Owner) /api/insults/{reference_id}/ |
# Insult Details API endpoint for CRUD operations on a single insult. - All users can read insults - Only the owner can update or delete their insult ## Endpoints - `GET… |
| DELETE |
Delete An Insult (Must Be Owner) /api/insults/{reference_id}/ |
# Insult Details API endpoint for CRUD operations on a single insult. - All users can read insults - Only the owner can update or delete their insult ## Endpoints - `GET… |
| GET |
List Insults By Category /api/insults/category/{category_name}/ |
Retrieve paginated insults filtered by category. Authenticated users see their own insults plus all active insults; unauthenticated users see only active insults. Supports both… |
| PUT |
Update Every Field of An Insult (Must Be Owner) /api/insults/{reference_id}/ |
# Insult Details API endpoint for CRUD operations on a single insult. - All users can read insults - Only the owner can update or delete their insult ## Endpoints - `GET… |
| Insult Categories | ||
| GET |
List Available Themes and Categories /api/categories/ |
# Categories & Themes API endpoint for listing insult categories organized by theme. - Returns all public insult categories, grouped under their themes - Includes metadata such… |
| Joke Reporting | ||
| POST |
Report A Joke /api/ |
Submit a report for a joke that may violate community guidelines. The report is validated and forwarded to the moderation team via a GitHub issue. Anonymous submissions are… |
| Schema | ||
| GET |
Get API Schema /api/schema/ |
OpenApi3 schema for this API. Format can be selected via content negotiation. - YAML: application/vnd.oai.openapi - JSON: application/vnd.oai.openapi+json |
| Health | ||
| GET |
API Status and Health Heartbeat /api/health/ |
Returns the aggregated health status of the service, including database connectivity, GraphQL schema availability, and LaunchDarkly client state. |
| User Management | ||
| POST |
Register for the API /auth/users/ |
Required only if you plan to contribute jokes. Just reading? No Need to Create an Account |
| POST |
Get Authorization Token /auth/token/login/ |
Use this endpoint to obtain user authentication token. |
| POST |
Deactivate a Auth Token /auth/token/logout/ |
Destroys the authentication token, effectively logging out the user. |
| PUT |
Update User Account Details /auth/users/me/ |
Updates an existing user account and returns the latest account details, including email address, username, first name, last name initial . This endpoint is typically used to… |
| DELETE |
Unregister for the API /auth/users/me/ |
Deletes the user account associated with the request and unregisters that user from the API. |
| GET |
Get User Details /auth/users/me/ |
Returns the details of the currently authenticated user account. This endpoint is typically used to retrieve the signed-in user’s profile and identity information, such as email… |
| POST |
auth_users_set_username_create /auth/users/set_username/ |
|
| Other endpoints | ||
| DELETE |
Delete a Specific Insult (Must Be Owner) /api/insults/{reference_id} |
Deletes an existing insult record. The response returns a confirmation message and the identifier of the deleted resource. |
| GET |
list_categories /api/categories/ |
# Categories & Themes API endpoint for listing insult categories organized by theme. - Returns all public insult categories, grouped under their themes - Includes metadata such… |
| POST |
create-insult /api/insults/new |
# Create New Insult (Must Be Registered User) Creates new insults owned by authenticated users. New insults default to 'Pending' status pending approval. ## Endpoints: POST… |
| PUT |
Completely Update a Specific Insult (Must Be Owner) /api/insults/{reference_id} |
Replaces an existing insult record with the new values provided in the request body. The response returns the fully updated insult object. |
| GET |
Retrieve a specific insult by ID /api/insults/{reference_id} |
Returns a single insult record. The response includes the insult text itself, its unique reference identifier, the assigned category, moderation flags, publication status,… |
| GET |
health_check /api/health/ |
Returns the aggregated health status of the service, including database connectivity, GraphQL schema availability, and LaunchDarkly client state. |
| PUT |
auth_users_update /auth/users/{id}/ |
|
| GET |
List all available insult categories /api/categories |
# Categories & Themes API endpoint for listing insult categories organized by theme. - Returns all public insult categories, grouped under their themes - Includes metadata such… |
| GET |
list_insults_by_category /api/insults/category/{category_name}/ |
Retrieve paginated insults filtered by category. Authenticated users see their own insults plus all active insults; unauthenticated users see only active insults. Supports both… |
| PATCH |
Partially Update a Specific Insult (Must Be Owner) /api/insults/{reference_id} |
Successful response. Partially updates an existing insult record and returns the updated object. |
| GET |
auth_users_me_retrieve /auth/users/me/ |
|
| PUT |
update_insult /api/insults/{reference_id}/ |
# Insult Details API endpoint for CRUD operations on a single insult. - All users can read insults - Only the owner can update or delete their insult ## Endpoints - `GET… |
| POST |
auth_users_reset_password_confirm_create /auth/users/reset_password_confirm/ |
|
| POST |
auth_users_resend_activation_create /auth/users/resend_activation/ |
|
| PATCH |
auth_users_partial_update /auth/users/{id}/ |
|
| POST |
auth_users_activation_create /auth/users/activation/ |
|
| POST |
auth_token_destroy /auth/token/logout/ |
Destroys the authentication token, effectively logging out the user. |
| POST |
auth_users_reset_username_create /auth/users/reset_username/ |
|
| POST |
auth_users_set_password_create /auth/users/set_password/ |
|
| DELETE |
auth_users_destroy /auth/users/{id}/ |
|
| POST |
auth_users_reset_password_create /auth/users/reset_password/ |
|
| POST |
auth_token_login_create /auth/token/login/ |
Use this endpoint to obtain user authentication token. |
| PATCH |
auth_users_me_partial_update /auth/users/me/ |
|
| GET |
auth_users_list /auth/users/ |
|
| POST |
auth_users_set_username_create /auth/users/set_username/ |
|
| DELETE |
auth_users_me_destroy /auth/users/me/ |
|
| POST |
auth_users_reset_username_confirm_create /auth/users/reset_username_confirm/ |
|
| GET |
retrieve_insult /api/insults/{reference_id}/ |
Retrieve a specific insult by reference_id. |
| GET |
auth_users_retrieve /auth/users/{id}/ |
|
| PUT |
auth_users_me_update /auth/users/me/ |
|
| POST |
auth_users_create /auth/users/ |
|
| PATCH |
partial_update_insult /api/insults/{reference_id}/ |
# Insult Details API endpoint for CRUD operations on a single insult. - All users can read insults - Only the owner can update or delete their insult ## Endpoints - `GET… |
+ 37 more endpoints on the provider's documentation.
The Dozens - The Yo Momma Joke pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
