Getting started with the mogenius API

Create an account for mogenius

1. Go to mogenius.com and create an account app.mogenius.com
2. Validate your email and phone number
3. Login through the API to obtain your accessToken. You can test the login endpoint here.

Feedback and Troubleshooting

If you run into any trouble, if you have questions, or if you have feedback we're inviting you to join our Discord. We're there to help you, so feel free to send us a message or post your questions to the mogenius community.

Rate-Limiting

Some endpoints do apply rate limiting. If you hit the rate limit, you will get a Cloudflare block message for 1 minute. If this is continuously affecting your project, please let us know.

Limitations

User registration and password reset are not available through the public API. Please use the mogenius studio for these tasks.

An example for login to get started

Use the following cURL to obtain your access token. Please replace "YOUR_EMAIL" and "YOUR_PASSWORD" with your own and execute:

curl --location --request POST 'http://api.mogenius.com/auth/login' \
--header 'Authorization: Basic RFItTkY0TFI1clkyd0V3TlFZV1BfOkVXTE9lY0lmT0U1aFFOQV9hM04xRg==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'email=YOUR_EMAIL' \
--data-urlencode 'password=YOUR_PASSOWRD' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'Device=mogenius_api'

This is the response you can expect. Test the endpoint in our Login section.

{
    "accessToken": "89bd16b9385d0363aad56059f40a058b42267432",
    "accessTokenExpiresAt": "2022-06-01T06:31:30.000Z",
    "refreshToken": "d830548b6a50553da1ec6f8b8cbe4fce2c295d65",
    "refreshTokenExpiresAt": "2023-05-31T06:31:30.000Z",
    "scope": [],
    "client": {
        "id": "DR-NF4LR5rY2wEwNQYWP_",
        "grants": [
            "refresh_token",
            "password"
        ],
        "redirectUris": [
            ""
        ]
    },
    "user": {
        "id": "a2fdc27b-a5ab-4a41-83ad-1b064d791716"
    }
}