Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/instance

Instance info

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/mastodon-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/mastodon-api/v1/instance" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/mastodon-api/v1/instance", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/mastodon-api/v1/instance");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/mastodon-api/v1/instance",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "icon": [
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-36x36-DLiBQg3N.png",
                "size": "36x36"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-48x48-C7lKWFwX.png",
                "size": "48x48"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-72x72-9LRpA3QN.png",
                "size": "72x72"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-96x96-BKKwkkY-.png",
                "size": "96x96"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-144x144-D-ewI-KZ.png",
                "size": "144x144"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-192x192-jYKJbpas.png",
                "size": "192x192"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-256x256-DXt2vsq7.png",
                "size": "256x256"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-384x384-CbK7cG33.png",
                "size": "384x384"
            },
            {
                "src": "https://mastodon.social/packs/assets/android-chrome-512x512-Dz2ThkhV.png",
                "size": "512x512"
            }
        ],
        "rules": [
            {
                "id": "1",
                "hint": "This includes content that is particularly provocative even if it may not show specific body parts, as well as dead bodies, bloody injuries, and other gore. Particularly obscene content may be prohibited entirely. Profile pictures and header images may not contain sexually explicit or violent media.",
                "text": "Sexually explicit or violent media must be marked as sensitive or with a content warning",
                "translations": {
                    "de": {
                        "hint": "Das beinhaltet ausdrücklich provokative Inhalte, auch wenn keine bestimmten Körperteile zu sehen sind, sowie Leichname, blutige Verletzungen und vergleichbare extreme Darstellungen. Besonders obszöne Inhalte können vollständig verboten werden. Profil- und Titelbilder dürfen keine sexuell expliziten oder Gewaltdarstellungen abbilden.",
                        "text": "Sexuell explizite Darstellungen oder solche von Gewalt müssen mit einer Inhaltswarnung versehen werden."
                    },
                    "es": {
                        "hint": "Esto incluye contenido especialmente provocativo, aunque no muestre partes específicas del cuerpo, así como cadáveres, heridas sangrientas y otras escenas sangrientas. Los contenidos especialmente obscenos pueden prohibirse por completo. Las fotos de perfil y las imágenes de cabecera no pueden contener contenido sexual explícito o violento.",
           
…