Error & Validation Responses

The API will respond with the following HTTP response codes:

Unauthorized response

{
  "statusCode": 401,
  "type": "UNAUTHORIZED",
  "errors": [{
    "message": "Invalid API key"
  }]
}

Forbidden response

{
  "statusCode": 403,
  "type": "FORBIDDEN",
  "errors": [{
    "message": "The API key doesn't have permissions to perform the request."
  }]
}

Validation error

{
  "statusCode": "400",
  "type": "VALIDATION_ERROR",
  "errors": [{
    "field": "name",
    "message": "Invalid name length."
  }]
}

Validation error without specific field

{
  "statusCode": "400",
  "type": "VALIDATION_ERROR",
  "errors": [{
    "message": "Missing or required parameters."
  }]
}

Object not found

{
  "statusCode": "404",
  "type": "OBJECT_NOT_FOUND",
  "errors": [{
    "message": "The order does not exist."
  }]
}

Invalid URL

{
  "statusCode": "404",
  "type": "ROUTE_NOT_FOUND",
  "errors": [{
    "message": "The provided URL does not exist."
  }]
}

Rate limit reached

{
  "statusCode": "429",
  "type": "TOO_MANY_REQUESTS",
  "errors": [{
    "message": "Too many requests."
  }]
}

Internal server error

{
  "statusCode": "500",
  "type": "INTERNAL_ERROR",
  "errors": [{
    "message": "Something went wrong with the request."
  }]
}

Last updated February 19, 2021

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2021 MoPub (a division of Twitter, Inc.)