Common Errors

This section lists the errors in the responses from the REST APIs of SwiftFederation solutions. For the errors specific to an API, please check the corresponding API document.

Error Syntax

The error properties of the JSON object, along with the Status Code and the Reason Phrase, in the response is used to indicate the specific information of the error of the API call:

• code: the error code, i.e. "INVALID_REQUEST" in the example below.
• message: the error message， i.e. "Invalid request parameters" in the example below.

HTTP/1.1 401
Date: Wed, 06 Aug 2025 09:42:16 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
x-sfd-trace-id: 83833830e1f94b5586e9187e366c5c7c

{
  "code":"Signature.NotMatch",
  "message":"The request signature that we calculate does not match the signature that you provided."
}

Status Codes, Error Codes and Error Messages

HTTP status code	Error code	Error message
400	Request.BadRequest	Bad request.
400	CustomerId.Invalid	CustomerId is empty or invalid.
400	ProductId.Invalid	ProductId is empty or invalid.
400	AuthorizationFormat.Invalid	Authorization format is invalid.
400	AccessKeyId.Invalid	AccessKeyId is empty or invalid.
400	Timestamp.Invalid	X-SFD-Date is empty or invalid.
400	Nonce.Invalid	X-SFD-Nonce is empty or invalid.
400	URI.Invalid	URI is empty or invalid.
400	Signature.Version.Invalid	X-SFD-Signature-Version is not supported.
400	Signature.Expired	The value of X-SFD-Date should be within 1 hour earlier or later than current time.
400	Method.Invalid	Method is empty or invalid.
400	AccountId.Invalid	AccountId is empty or invalid.
400	Name.Invalid	Name is empty or invalid.
400	ParentId.Invalid	ParentId is empty or invalid.
400	Type.Invalid	Type is empty or invalid.
401	Signature.NotMatch	The request signature that we calculate does not match the signature that you provided.
401	AccessCredential.Invalid	Access key id is not correct.
403	Permission.Forbidden	Can't access according to this app key.
403	CustomerName.Conflict	Can't execute because name exist.
403	Parent.NotExist	Can't execute because parentId does not exist.
403	CustomerType.Invalid	Can't execute because parent type is not partner.
403	CustomerChild.Exist	Can't execute because customer has child customer.
403	Customer.NotExist	Can't execute because customer does not exist.
403	Product.VAS.Subscription.Invalid	Package from solution has not been subscribed.
403	Product.Subscription.Invalid	Product has not been subscribed.
403	Account.NotExist	Can't execute because account does not exist.
403	Permission.Forbidden	Can't access according to this account id.
404	TargetCustomerId.NotFound	Target customer id is not found.
404	Customer.NotFound	Customer is not found.
405	Request.MediaTypeNotSupported	Content type is not supported.