HomeSYSTEMAUTHDBFILESVALIDATIONMEDIA_FILESECURITYCOPY_APPROVALCLIENTORDER

Error Codes

This page contains the possible error codes to consider when using the APIs.

SYSTEM

System level errors uncaught by categorized handlers.

Parameters
SYSTEM.UNCAUGHT

9999

 System hiccup! We have been alerted and will be resolving the issue as soon as we can. 

SYSTEM.NETWORK

9001

 System hiccup! We have been alerted and will be resolving the issue as soon as we can. 

SYSTEM.CONFIGURATION

9002

 System hiccup! We have been alerted and will be resolving the issue as soon as we can. 

Response

A sample system error:

{
  "statusCode": 501,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "SYSTEM.UNCAUGHT",
      "code": 9999,
      "isBwError": true,
      "message": "System hiccup! We have been alerted and will be resolving the issue as soon as we can"
    }
  }
}
AUTH

Authentication and authorization errors.

Parameters
AUTH.UNAUTHORIZED_API_ACCESS

5000

 Unauthorized

AUTH.FLAGGED_ITEM

5001

 Resource has been flagged for administration

AUTH.TOKEN_INVALID

5002

 Permission denied

AUTH.TOKEN_EXPIRED

5003

 Permission denied

AUTH.FORBIDDEN_API_ACCESS

5004

 Permission denied

AUTH.MISSING_REFRESH_TOKEN_PAYLOAD

5005

 Permission denied

AUTH.MISSING_REFRESH_TOKEN_SECRET

5006

 Permission denied

AUTH.MISSING_REQ

5007

 Permission denied

AUTH.CANNOT_SIGN_TOKEN

5008

 Permission denied

AUTH.INVALID_CREDENTIALS

5009

 Invalid credentials

AUTH.USER_ACCOUNT_EXPIRED

5010

 Permission denied

AUTH.USER_ACCOUNT_LOCKED

5011

 Permission denied

AUTH.USER_REQUIRES_MFA

5012

 Permission denied

AUTH.USER_MFA_TOKEN_INVALID

5013

 Permission denied

AUTH.MISSING_TRANSFER_TOKEN_PAYLOAD

5014

 Permission denied

AUTH.REFRESH_TOKEN_INVALID

5015

 Permission denied

AUTH.REFRESH_TOKEN_EXPIRED

5016

 Permission denied

AUTH.TRANSFER_TOKEN_INVALID

5017

 Permission denied

AUTH.TRANSFER_TOKEN_EXPIRED

5018

 Permission denied

AUTH.UNSUPPORTED_STRATEGY

5019

 Permission denied

AUTH.UNAUTHORIZED_IP_ADDRESS

5020

 Permission denied

AUTH.SAML_ERROR

5021

 System error

AUTH.OIDC_ERROR

5022

 System error

AUTH.UNKNOWN_OIDC_ISSUER

5023

 System error

AUTH.USER_PASSWORD_INVALID

5024

 Password recently used

Response

A sample auth error:

{
  "statusCode": 401,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "AUTH.UNAUTHORIZED_API_ACCESS",
      "code": 5000,
      "isBwError": true,
      "message": "Unauthorized"
    }
  }
}
DB

Database errors.

Parameters
DB.NO_QUERY_RESULTS

6000

 No results

DB.NO_DB_CONNECTION

6001

 System error, please check back later

DB.DUPLICATE

6002

 Already exists

DB.ACCESS_DENIED

6003

 Access denied

DB.UNKNOWN

6999

 System error

DB.MISSING_CONNECTION

6998

 System error

Response

A sample database error:

{
  "statusCode": 409,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "DB.DUPLICATE",
      "code": 6002,
      "isBwError": true,
      "message": "Already exists"
    }
  }
}
FILES

File upload and parsing errors.

Parameters
FILES.UNSUPPORTED_TYPE

8000

 Unsupported file type

FILES.TOO_LARGE

8001

 File too large

FILES.UNSUPPORTED_FILE_EXTENSION

8002

 Unsupported file extension

FILES.UPLOAD_CANCELLED

8003

 User cancelled upload

Response

A sample file error:

{
  "statusCode": 415,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "FILES.UNSUPPORTED_TYPE",
      "code": 8000,
      "isBwError": true,
      "message": "Unsupported file type"
    }
  }
}
VALIDATION

API payload validation errors.

Parameters
VALIDATION.REQUIRED

7000

 Missing required property

VALIDATION.UNSUPPORTED

7001

 Unsupported property

VALIDATION.VALUE

7002

 Illegal value for property

VALIDATION.MAX_CHAR_COUNT

7003

 Exceeded maximum character count

Response

A sample validation error:

{
  "statusCode": 400,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "VALIDATION.VALUE",
      "code": 7002,
      "isBwError": true,
      "message": "Illegal value for property"
    }
  }
}
MEDIA_FILE

Media pipeline conversion errors.

Parameters
MEDIA_FILE.VARIANT_CREATION_FAILURE

9000

 Failed to create variant

MEDIA_FILE.VARIANT_CREATION_FAILURE_PROCESS_KILLED

9001

 Process to create media asset variant killed. The uploaded file is likely too large

MEDIA_FILE.DUPLICATE_FILE_FOUND

9002

 A file by that name in that language already has been added to this order. Please delete the file and try again

MEDIA_FILE.INVALID_MIME_TYPE

9003

 The role %s does not allow files of type %s. Please try again with another file

MEDIA_FILE.PRESIGNED_URL_CREATION_FAILED

9004

 There was an error while generating a pre-signed url for your file. Please try again

MEDIA_FILE.MEDIA_GROUP_CREATION_FAILED

9005

 There was an error while generating a media group. Please try again

Response

A sample media conversion error:

{
  "statusCode": 400,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "MEDIA_FILE.INVALID_MIME_TYPE",
      "code": 9003,
      "isBwError": true,
      "message": "The role %s does not allow files of type %s. Please try again with another file"
    }
  }
}
SECURITY

Security errors.

Parameters
SECURITY.VIRUS_SCAN_FAILED

10000

 Uploaded file failed virus scanning

SECURITY.REQUEST_ID_MISMATCH

10001

 Provided x-request-id request header did not match the echoed response header

Response

A sample security error:

{
  "statusCode": 400,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "SECURITY.VIRUS_SCAN_FAILED",
      "code": 10000,
      "isBwError": true,
      "message": "Uploaded file failed virus scanning"
    }
  }
}
COPY_APPROVAL

Copy approval errors.

Parameters
COPY_APPROVAL.NEWSML_PARSE_FAILURE

11000

 Cannot parse NewsML response

Response

A sample copy approval error:

{
  "statusCode": 500,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "COPY_APPROVAL.NEWSML_PARSE_FAILURE",
      "code": 11000,
      "isBwError": true,
      "message": "Cannot parse NewsML response"
    }
  }
}
CLIENT

Business Wire client specific errors.

Parameters
CLIENT.RESOURCE_NOT_FOUND

12000

 Not found

CLIENT.PAYLOAD_NOT_ACCEPTABLE

12001

 Bad payload

Response

A sample client error:

{
  "statusCode": 404,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "CLIENT.RESOURCE_NOT_FOUND",
      "code": 12000,
      "isBwError": true,
      "message": "Not found"
    }
  }
}
ORDER

Order specific errors.

Parameters
ORDER.ALREADY_SUBMITTED

13000

 Order has already been submitted

ORDER.UNSUPPORTED_ACTION

13001

 Unsupported action for this order based on its draft or published status

Response

A sample order error:

{
  "statusCode": 500,
  "flash": {
    "notice": [],
    "error": []
  },
  "data": {
    "err": {
      "name": "ORDER.ALREADY_SUBMITTED",
      "code": 13000,
      "isBwError": true,
      "message": "Order has already been submitted"
    }
  }
}