Upload files
POST/open-api/v3/files/upload
Uploads one or more image or document files as multipart/form-data and returns an id for each. Use these ids in the image fields of the KYC, KYB and identity calls. No query parameters are accepted, and the upload must be within the size limit.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 502
- 503
Success. The body is the standard envelope with code 000000.
The request was refused as invalid.
| Code | Meaning |
|---|---|
NB40001 | The call needs an account and none was given. |
NB40002 | The request is malformed. |
NB40010 | A required value is missing. The message names the field when it can. |
NB40011 | A parameter is not valid. The message names the field when it can. |
NB40012 | A phone number or email address is not in a valid format. |
NB40013 | A name or address field is too short or not in a valid format. |
NB40014 | The text contains characters that are not supported. |
NB40015 | The uploaded file cannot be accepted: empty, too large, or its extension does not match its format. |
NB40016 | The identity or business details are not valid. |
NB40017 | A value or option is not supported for this call. |
NB40018 | The card limit cannot be set. |
NB40019 | The amount or fee is not accepted. |
NB40020 | There is not enough balance. Top up the account or lower the amount. |
NB40021 | The card has reached its limit. |
NB40022 | The card's current status does not allow this. |
NB40023 | The address is flagged as high risk and cannot be used. |
NB40024 | The payment details are not valid. |
NB40025 | The exchange rate can no longer be used. Request a new one. |
NB40099 | Card processing refused the request for a reason with no code of its own yet. The status is the one card processing returned. |
NB40903 | (HTTP 409) Another request for this is already in progress. Repeat it with the same idempotency key. |
NB40904 | (HTTP 409) A user with these details already exists. |
The caller could not be identified.
| Code | Meaning |
|---|---|
NB40102 | The access token is not valid or has expired. Fetch a new token and retry once. |
NB40101 | Invalid client. |
The caller is known but may not do this.
| Code | Meaning |
|---|---|
NB40301 | The account is not one of yours. |
NB40302 | The resource is not one of yours. |
NB40303 | This endpoint is not enabled for your client. |
NB40304 | Your client is suspended. |
NB40305 | The call came from an IP address that is not allowed. |
NB40306 | The service is not enabled for your client. |
NB40310 | The KYC call names a different person from the one first submitted for this account. |
NB40311 | The KYC call names a person who is already submitted on another account. |
NB40312 | The request or answer names a resource reserved to NAS. |
NB40314 | Your client is not yet fully configured for production. Contact NAS support. |
NB40320 | This is not permitted for this account or resource. |
NB40321 | This account cannot be used for this operation. |
NB40322 | The account is not active. Contact NAS. |
NB40323 | The card has an outstanding balance. Contact NAS. |
The path is not part of this API, or the resource does not exist.
| Code | Meaning |
|---|---|
NB40400 | Not found. |
NB40402 | The card was not found. |
NB40410 | Something named in the request was not found. The message names it when it can. |
The client has used its request allowance for the minute. Wait the number of seconds in the
Retry-After header, then retry. The call was not forwarded, so it is safe to repeat as it was.
| Code | Meaning |
|---|---|
NB42902 | Request limit reached. |
NB42903 | Card processing is receiving requests too quickly. Wait a few seconds, then repeat the call. |
Response Headers
Whole seconds to wait before the next call.
The call was made but the answer could not be returned.
| Code | Meaning |
|---|---|
NB50201 | The answer was withheld because it could not be safely returned. Read the resource before retrying a call that creates something. |
NB50210 | Card processing answered in a form that could not be used. Read the resource before repeating a call that creates something. |
The service could not complete the call. Retry later with the same idempotency key.
| Code | Meaning |
|---|---|
NB50301 | Upstream unavailable. |
NB50302 | Usage metering is unavailable. |
NB50002 | (HTTP 500) Card processing could not complete the call. Retry with the same idempotency key. |
NB50299 | Card processing failed for a reason with no code of its own yet. The status is the one card processing returned. |
NB50303 | Card processing is temporarily unavailable. |
NB50305 | NAS needs to take an action before this can complete. Retry later; contact NAS if it persists. |