{"openapi":"3.2.0","info":{"title":"Jmail API","description":"Jmail (jmail.world) — Jeffrey Epstein's Emails Data API. Includes emails, documents, contents, photos, people, iMessages, stars, metadata informations and more endpoints.","version":"1.0.0"},"servers":[{"url":"https://jmail.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Emails"},{"name":"Documents"},{"name":"Photos"},{"name":"People"},{"name":"iMessages"},{"name":"Stars & Metadata"}],"paths":{"/v1/emails":{"get":{"operationId":"get_v1_emails","summary":"List/search emails (without body content)","tags":["Emails"],"parameters":[{"name":"q","in":"query","description":"Search in subject","required":false,"schema":{"type":"string","title":"q"}},{"name":"sender","in":"query","description":"Filter by sender","required":false,"schema":{"type":"string","title":"sender"}},{"name":"to","in":"query","description":"Filter by recipient","required":false,"schema":{"type":"string","title":"to"}},{"name":"date_from","in":"query","description":"Start date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"date_from"}},{"name":"date_to","in":"query","description":"End date (YYYY-MM-DD)","required":false,"schema":{"type":"string","title":"date_to"}},{"name":"release_batch","in":"query","description":"Filter by release batch ID","required":false,"schema":{"type":"string","title":"release_batch"}},{"name":"epstein_is_sender","in":"query","description":"Only emails sent by Epstein","required":false,"schema":{"type":"string","title":"epstein_is_sender"}},{"name":"is_promotional","in":"query","description":"Filter promotional emails","required":false,"schema":{"type":"string","title":"is_promotional"}},{"name":"order","in":"query","description":"asc or desc by sent_at","required":false,"schema":{"type":"string","title":"order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/emails/details":{"get":{"operationId":"get_v1_emails_details","summary":"Get single email with full content","tags":["Emails"],"parameters":[{"name":"email_id","in":"query","required":false,"schema":{"type":"string"}}]}},"/v1/emails/search":{"get":{"operationId":"get_v1_emails_search","summary":"Full-text search in email body content","tags":["Emails"],"parameters":[{"name":"q","in":"query","description":"Search in email body (markdown)","required":false,"schema":{"type":"string","title":"q"}},{"name":"sender","in":"query","description":"Filter by sender","required":false,"schema":{"type":"string","title":"sender"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/emails/stats/top-senders":{"get":{"operationId":"get_v1_emails_stats_top_senders","summary":"Top email senders","tags":["Emails"],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}}]}},"/v1/emails/stats/timeline":{"get":{"operationId":"get_v1_emails_stats_timeline","summary":"Email count per month","tags":["Emails"]}},"/v1/documents":{"get":{"operationId":"get_v1_documents","summary":"List/search documents","tags":["Documents"],"parameters":[{"name":"q","in":"query","description":"Search in filename or description","required":false,"schema":{"type":"string","title":"q"}},{"name":"source","in":"query","description":"Filter by source (e.g. DOJ, HOUSE_OVERSIGHT)","required":false,"schema":{"type":"string","title":"source"}},{"name":"release_batch","in":"query","description":"Filter by release batch","required":false,"schema":{"type":"string","title":"release_batch"}},{"name":"volume","in":"query","description":"Filter by volume number","required":false,"schema":{"type":"string","title":"volume"}},{"name":"has_thumbnail","in":"query","description":"Only docs with thumbnails","required":false,"schema":{"type":"string","title":"has_thumbnail"}},{"name":"min_pages","in":"query","description":"Minimum page count","required":false,"schema":{"type":"string","title":"min_pages"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/documents/{doc_id}":{"get":{"operationId":"get_v1_documents_doc_id","summary":"Get document by ID","tags":["Documents"],"parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/photos/{photo_id}":{"get":{"operationId":"get_v1_photos_photo_id","summary":"Get photo by ID with face data","tags":["Photos"],"parameters":[{"name":"photo_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/photos":{"get":{"operationId":"get_v1_photos","summary":"List/search photos","tags":["Photos"],"parameters":[{"name":"q","in":"query","description":"Search in AI-generated description","required":false,"schema":{"type":"string","title":"q"}},{"name":"source","in":"query","description":"Filter by source","required":false,"schema":{"type":"string","title":"source"}},{"name":"content_type","in":"query","description":"Filter by content type (e.g. image/jpeg)","required":false,"schema":{"type":"string","title":"content_type"}},{"name":"person_id","in":"query","description":"Filter photos containing this person","required":false,"schema":{"type":"string","title":"person_id"}},{"name":"min_width","in":"query","description":"Minimum width in pixels","required":false,"schema":{"type":"string","title":"min_width"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/people/{person_id}":{"get":{"operationId":"get_v1_people_person_id","summary":"Get person by ID with their photos","tags":["People"],"parameters":[{"name":"person_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/people":{"get":{"operationId":"get_v1_people","summary":"List/search identified people","tags":["People"],"parameters":[{"name":"q","in":"query","description":"Search by name","required":false,"schema":{"type":"string","title":"q"}},{"name":"source","in":"query","description":"Filter by source","required":false,"schema":{"type":"string","title":"source"}},{"name":"min_photos","in":"query","description":"Minimum photo count","required":false,"schema":{"type":"string","title":"min_photos"}},{"name":"sort","in":"query","description":"Sort by: name, photo_count","required":false,"schema":{"type":"string","title":"sort"}},{"name":"order","in":"query","description":"asc or desc","required":false,"schema":{"type":"string","title":"order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/messages/conversations/{slug}":{"get":{"operationId":"get_v1_messages_conversations_slug","summary":"Get conversation with its messages","tags":["iMessages"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/messages/conversations":{"get":{"operationId":"get_v1_messages_conversations","summary":"List all iMessage conversations","tags":["iMessages"]}},"/v1/messages":{"get":{"operationId":"get_v1_messages","summary":"Search all messages","tags":["iMessages"],"parameters":[{"name":"q","in":"query","description":"Search in message text","required":false,"schema":{"type":"string","title":"q"}},{"name":"sender","in":"query","description":"Filter by sender","required":false,"schema":{"type":"string","title":"sender"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}},"/v1/stars/batches":{"get":{"operationId":"get_v1_stars_batches","summary":"Get release batches","tags":["Stars & Metadata"]}},"/v1/stars":{"get":{"operationId":"get_v1_stars","summary":"Get star counts (crowd-sourced importance)","tags":["Stars & Metadata"],"parameters":[{"name":"entity_type","in":"query","description":"Filter by type (e.g. email, document, photo)","required":false,"schema":{"type":"string","title":"entity_type"}},{"name":"entity_id","in":"query","description":"Get stars for specific entity","required":false,"schema":{"type":"string","title":"entity_id"}},{"name":"min_count","in":"query","description":"Minimum star count","required":false,"schema":{"type":"string","title":"min_count"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string","title":"limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"string","title":"offset"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}