API Error Status

On error, all MetaKeep HTTP APIs return non-200 HTTP code. The response also contains a JSON object with a status field which looks like this:

{
  status: "INVALID_REQUEST"
}

You can find list of error status returned by all MetaKeep APIs below.

Common Errors

The table below lists all the common errors returned by MetaKeep APIs.

StatusHTTP CodeDescription
UNAUTHORIZED401The request is not authorized. This can happen if the API key, Account key, or App id is invalid or if the request is not signed correctly.
INVALID_ACCOUNT_KEY401The provided key is not a valid account key. Account keys start with account_key_.
FORBIDDEN403The request is forbidden. This can happen if the API key, Account key, or App iddoes not have access to the requested resource.
INVALID_REQUEST400The request data is invalid. This can happen if the request is missing the required fields or if the request data is malformed.
UNSUPPORTED_OPERATION400The API is not supported on the chain. Please contact us if you need support for this API on the chain.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v3/getWallet

StatusHTTP CodeDescription
INVALID_EMAIL400The user email is not a valid email.

/v3/getWallet/multiple

StatusHTTP CodeDescription
INVALID_EMAIL400One of the user emails is not a valid email.
TOO_MANY_USERS_REQUESTED400You are trying to query wallets for a lot of users. Please check the API limitations.

/v3/wallet/getUser

StatusHTTP CodeDescription
INVALID_WALLET_ADDRESS400The provided wallet address is not valid.
USER_NOT_FOUND404No user was found for the provided wallet address.

/v3/getDeveloperWallet

StatusHTTP CodeDescription
MISSING_APP_ID400The appId field is missing in the request. This is required when making requests using the account keys.
FORBIDDEN403The API key is not valid.

/v2/app/nft/createCollection

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_NAME400Collection name is either empty or too long.

Collection name currently has a character limit of 20.

Our current recommendation is to use metadata/name for a verbose name which has the added bonus of ability to dynamically change the collection name without fees.
INVALID_SYMBOL400Collection symbol is either empty or too long.

Collection symbol currently has a character limit of 10.
INVALID_METADATA400Collection metadata is invalid e.g. invalid uri, invalid fee recipient.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/listCollections

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/listTokens

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid or doesn't exist.
TOO_MANY_COLLECTIONS400You have provide more than 20 collections in the request.

Note that you can get all NFTs owned by the user by not sending any collection in the request.
INVALID_USER400of user is not valid.

Currently we only support email and eth address.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/lock

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid or doesn't exist.
INVALID_TOKEN400Token is empty or invalid.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/unlock

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid or doesn't exist.
INVALID_TOKEN400Token is empty or invalid.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/mint

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid or doesn't exist.
INVALID_METADATA400Token metadata is invalid e.g. invalid uri.
INVALID_TARGET400Mint to user is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/transfer

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid or the current user is not allowed to perform the nft transfer.
FORBIDDEN_CONTRACT_NOT_OWNED403The API key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400The collection address is not valid or doesn't exist.
INVALID_TOKEN400The token is empty or invalid.
FORBIDDEN_TOKEN_NOT_OWNED403The token is not owned by the from user.
TOKEN_NOT_FOUND404The token doesn't exist on the chain.
INVALID_FROM_USER400Transfer from user is not valid.

Currently, only email address is supported.
INVALID_TARGET400Transfer to user is not valid.

Currently, only email and external wallet addresses are supported.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has a different request body.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/nft/metadata

🚧

This endpoint doesn't return status in the response body

HTTP CodeDescription
400Request is not valid e.g. if query params has unsupported fields.
404No metadata found for the nft token.
500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/metadata/updateToken

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid.
INVALID_METADATA400Token metadata is invalid e.g. invalid uri.
INVALID_TOKEN400Token is empty or invalid.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/nft/metadata/updateCollection

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_COLLECTION400Collection address is not valid.
INVALID_METADATA400Collection metadata is invalid e.g. invalid uri.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/createCurrency

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_NAME400Collection name is either empty or too long.

Collection name currently has a character limit of 20.
INVALID_SYMBOL400Collection symbol is either empty or too long.

Collection symbol currently has a character limit of 10.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/listCurrencies

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/mint

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_CURRENCY400Currency address is not valid or doesn't exist.
INVALID_AMOUNT400Mint amount is not valid.
INVALID_TARGET400Mint to user is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/lock

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_CURRENCY400Currency address is not valid or doesn't exist.
INVALID_AMOUNT400Lock amount is not valid.
INVALID_USER400User whose coins to lock is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/unlock

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_CURRENCY400Currency address is not valid or doesn't exist.
INVALID_AMOUNT400Unlock amount is not valid.
INVALID_USER400User whose coins to lock is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/burn

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_CURRENCY400Currency address is not valid or doesn't exist.
INVALID_AMOUNT400Burn amount is invalid.
INVALID_USER400Burn from user is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/balance

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
INVALID_CURRENCY400The currency address is not valid or doesn't exist.
MISSING_CURRENCY_LIST400The request is missing the list of currencies.
TOO_MANY_CURRENCIES400You have provided more than 20 currencies in the request.

Note that you can get all currencies owned by the user by not sending any currency in the request.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/coin/transfer

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid or current user is not allowed to perform the coin transfer.
FORBIDDEN_CONTRACT_NOT_OWNED403Api key is not allowed to perform operations on the collection.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
INVALID_CURRENCY400Currency address is not valid or doesn't exist.
INVALID_SYMBOL400Currency symbol is not valid or doesn't exist.
INVALID_AMOUNT400Transfer amount is invalid.
INVALID_FROM_USER400Transfer from user is not valid.

Currently we only support email address and developer's own account.
INVALID_TARGET400Transfer to user is not valid.

Currently we only support email and eth address.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has different request body.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/sign/transaction

StatusHTTP CodeDescription
INVALID_REASON400The reason for signing the transaction is not valid.
MISSING_NONCE400The nonce is missing. Please specify nonce for the transaction.
MISSING_GAS400Gas is missing. Please specify gas for the transaction.
INVALID_GAS_FEE_PARAMS400The transaction contains gasPrice maxFeePerGas and maxPriorityFeePerGas. Please specify either gasPrice or maxFeePerGas and maxPriorityFeePerGas
MISSING_GAS_PRICE400Gas price is missing for type 1 transactions. Please specify gasPrice.
MISSING_MAX_FEE_PER_GAS400The max fee per gas is missing for type 2 transactions. Please specify both maxFeePerGas and maxPriorityFeePerGas.
MISSING_MAX_PRIORITY_FEE_PER_GAS400The max priority fee per gas is missing for type 2 transactions. Please specify both maxFeePerGas and maxPriorityFeePerGas.
FROM_ADDRESS_DOES_NOT_MATCH_SIGNER400The from address in the transaction message does not match the signer's address.

/v2/app/sign/transaction/multiple


StatusHTTP CodeDescription
INVALID_REASON400The reason for signing the transaction is not valid.
MISSING_NONCE400The nonce is missing. Please specify nonce for the transaction.
MISSING_GAS400Gas is missing. Please specify gas for the transaction.
INVALID_GAS_FEE_PARAMS400The transaction contains gasPrice maxFeePerGas and maxPriorityFeePerGas. Please specify either gasPrice or maxFeePerGas and maxPriorityFeePerGas
MISSING_GAS_PRICE400Gas price is missing for type 1 transactions. Please specify gasPrice.
MISSING_MAX_FEE_PER_GAS400The max fee per gas is missing for type 2 transactions. Please specify both maxFeePerGas and maxPriorityFeePerGas.
MISSING_MAX_PRIORITY_FEE_PER_GAS400The max priority fee per gas is missing for type 2 transactions. Please specify both maxFeePerGas and maxPriorityFeePerGas.
FROM_ADDRESS_DOES_NOT_MATCH_SIGNER400The from address in the transaction message does not match the signer's address.
TOO_MANY_TRANSACTIONS400There are too many transactions in the batch. Currently, only up to 5 transactions are supported in a single batch.

/v2/app/sign/message

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
INVALID_REQUEST400Invalid data passed to sign operation.
Please get in touch with us if you are unable to fix this.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/sign/typedData

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
INVALID_REQUEST400Invalid data passed to sign operation.
Please get in touch with us if you are unable to fix this.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/transaction/status

StatusHTTP CodeDescription
FORBIDDEN403Api key is not valid.
INVALID_REQUEST400Request is not valid e.g. if request json has unsupported fields.
NOT_FOUND404Transaction not found.
SOMETHING_WENT_WRONG500Unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/lambda/create

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
BYTECODE_EXCEEDS_MAX_SIZE400Max supported bytecode size is 23 KB.

Note that the EVM contract size limit is 24.576 KB. Our limit is slightly lower to prevent users from experiencing random errors for large contracts.

Let us know if you are unable to resolve this. We will be happy to help with contract resizing.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
NAME_ARG_MISSING400The constructor is missing the lambdaName argument. lambdaName is a required constructor argument.
INVALID_NAME400Lambda's name is either empty or too long.

Lambda's name currently has a character limit of 20.
OWNER_ARG_MISSING400The constructor is missing the lambdaOwner argument. lambdaOwner is a required constructor argument.
INVALID_OWNER400The Lambda owner is not the same as the developer's wallet address.

Make sure you are initializing the lambda by passing in your developer account eth address as the lambda owner.
NAMES_DO_NOT_MATCH400The name provided in the name field and constructor lambdaName arg do not match.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has a different request body.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/import

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
INVALID_ABI400The abi is not valid.
INVALID_NAME400Lambda's name is either empty or too long.
Lambda's name currently has a character limit of 20.
INVALID_LAMBDA400The lambda address in the request is not valid
LAMBDA_ALREADY_EXISTS400Lambda with the same address already exists. Use /v2/app/lambda/update API to update the lambda.
CONTRACT_NOT_FOUND400A deployed contract with the given address was not found on the chain. Please make sure that the contract is deployed and the address is correct.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/listLambdas

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
SOMETHING_WENT_WRONG403An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/invoke

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403The API key is not allowed to perform operations on the lambda.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
INVALID_REASON400The invocation reason is not provided.
INVALID_DESCRIPTION_TEXT400The invocation description text is not provided
INVALID_DESCRIPTION_IMAGE400The invocation description image URL is not valid.
INVALID_USER_TYPE400Invoke as user is not valid.

Currently, we only support email addresses.
INVALID_FUNCTION400The provided function is not valid
INVALID_FUNCTION_READ_ONLY400You are trying to invoke a read-only (pure or view) function. Use /v2/app/lambda/read api to read data from lambda.
INVALID_FUNCTION_NOT_PAYABLE400You are trying to send payment(value) to a function that is not payable.
INVALID_ARGS400Function args list is not valid
INVALID_PAYMENT_AMOUNT400The payment amount provided is not a valid decimal string.
INVALID_MESSAGE400The serialized Solana transaction message is not valid.
MESSAGE_HAS_NO_SIGNERS400 The serialized Solana transaction message does not have any required signers.
USER_IS_NOT_SIGNER400The user invoking the lambda is not a signer for the serialized Solana transaction message.
INVALID_SIGNERS400The provided signers are invalid. This can happen if the signers are not valid public keys or if the signers are not the signers of the provided serialized transaction message.
INVALID_EXTERNAL_SIGNATURE400The provided external signature is not valid for the serialized Solana transaction message.
INSUFFICIENT_EXTERNAL_SIGNATURES400The number of external signatures provided is less than the required number of signatures for the serialized Solana transaction message. Please make sure all external signers have signed before sending the request.
INVALID_SPONSOR400The transaction fee payer is not valid. Use the /v2/app/lambda/getSponsor API to get the sponsor for the transaction.
SPONSOR_PAYMENT_NOT_ENABLED400This happens when the Sponsor account is used as an input to an instruction for rent payments/refunds. To safeguard your developer account from misuse and unexpected bills, the Sponsor only pays for transaction fees by default. Please get in touch with us if you need rent payment enabled for your app.
PRIORITY_FEE_TOO_HIGH400The priority fee(compute price on Solana) is too high. Currently, the maximum compute price that can be set on Solana is 1000000(1 million).
INVALID_SIGNATURES400The provided signatures are invalid. This can happen if the signatures are not valid signatures for the provided serialized transaction message.
CONTRACT_NOT_SUPPORTED_USE_BUSINESS_WALLET400The lambda contract can only be invoked using theBUSINESS_WALLET
PAYMENT_NOT_SUPPORTED_USE_BUSINESS_WALLET400The payment(value transfer) is only supported when using theBUISNESS_WALLET.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has a different request body.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/invoke/multiple

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403The API key is not allowed to perform operations on the lambda.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
INVALID_REASON400The invocation reason is not provided.
INVALID_DESCRIPTION_TEXT400The invocation description text is not provided
INVALID_DESCRIPTION_IMAGE400The invocation description image URL is not valid.
INVALID_USER_TYPE400Invoke as user is not valid.

Currently, we only support email addresses.
INVALID_FUNCTION400The provided function is not valid
INVALID_FUNCTION_READ_ONLY400You are trying to invoke a read-only (pure or view) function. Use /v2/app/lambda/read api to read data from lambda.
INVALID_FUNCTION_NOT_PAYABLE400You are trying to send payment(value) to a function that is not payable.
INVALID_ARGS400Function args list is not valid
INVALID_PAYMENT_AMOUNT400The payment amount provided is not a valid decimal string.
INVALID_PAYMENT_RECIPIENT400The payment recipient is not valid.
CONTRACT_NOT_SUPPORTED_USE_BUSINESS_WALLET400The lambda contract can only be invoked using theBUSINESS_WALLET
PAYMENT_NOT_SUPPORTED_USE_BUSINESS_WALLET400The payment(value transfer) is only supported when using theBUISNESS_WALLET.
BATCH_INVOCATION_UNSUPPORTED_USE_BUSINESS_WALLET400Batch invocation is only supported when using theBUISNESS_WALLET.
BATCH_INVOCATION_SIZE_EXCEEDED400The batch size is more than allowed. Please check API docs for the allowed batch size.
IDEMPOTENCY_KEY_MISSING400Idempotency key is missing.
IDEMPOTENCY_PARAMS_MISMATCH409Another request with the same Idempotency key has a different request body.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/read

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403The API key is not allowed to perform operations on the lambda.
INVALID_REQUEST400The request is not valid e.g. if the request JSON has unsupported fields.
INVALID_LAMBDA400The lambda address in the request is not valid
INVALID_FUNCTION400The provided function is not valid
NO_MATCHING_FUNCTION_FOUND400No function was found matching the name and args in the request.
NOT_READ_ONLY_FUNCTION400You are trying to call a function that's not read-only (pure or view). Use /v2/app/lambda/invoke API to invoke write functions and send a transaction.
READ_SIZE_EXCEEDED400You are trying to read a lot of data at once. Please go through the Lambda Read Limits doc for more information.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/lambda/read/events

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED403The API key is not allowed to perform operations on lambda.
INVALID_REQUEST400The request is not valid e.g. if the request JSON has unsupported fields.
INVALID_LAMBDA400The lambda address in the request is not valid
TOO_MANY_LAMBDAS400The request contains more lambdas than what is allowed. Please check the API documentation for the limits.
NEWEST_BLOCK_BEFORE_OLDEST_BLOCK400The newest block number is before the oldest block number.
INVALID_BLOCK_NUMBER400The block number is invalid. You can provide an integer string, hex string, or "LATEST".
TOO_MANY_BLOCKS_TO_READ_FROM400The block range is too large. Please check the API documentation for the limits.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/lambda/update

StatusHTTP CodeDescription
FORBIDDEN403The API key is not valid.
FORBIDDEN_CONTRACT_NOT_OWNED400The API key is not allowed to perform operations on lambda.
INVALID_REQUEST400The request is not valid e.g. if the request JSON has unsupported fields.
UNSUPPORTED_CONTRACT_TYPE400This happens if you are trying to update NFT or Coin contracts deployed using NFT/Coin APIs. You can only update your custom lambda contracts.
INVALID_LAMBDA400The lambda address in the request is not valid.
INVALID_ABI400The ABI is not valid.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/lambda/getBusinessWallet

StatusHTTP CodeDescription
INVALID_USER400The user in the request is not valid e.g. if the user email format is invalid.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/lambda/getBusinessWallet/multiple

StatusHTTP CodeDescription
INVALID_USER400One of the users is not valid.
TOO_MANY_USERS_REQUESTED400You are trying to query wallets for a lot of users. Please check the API limitations.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.

/v2/app/lambda/businessWallet/getUser

StatusHTTP CodeDescription
INVALID_WALLET_ADDRESS400The provided wallet address is not valid.
USER_NOT_FOUND404No user was found for the provided wallet address.

/v2/app/lambda/getSponsor

StatusHTTP CodeDescription
INVALID_REQUEST400The request is not valid e.g. if the request JSON has unsupported fields.
SOMETHING_WENT_WRONG500An unknown error occurred.
Please get in touch with us if you continue seeing this error.

/v2/app/create

StatusHTTP CodeDescription
INVALID_NAME400The app name is invalid. It should be between 1 and 64 characters long.
INVALID_CHAIN_ID400The chain ID is invalid. Please check the API documentation for the list of supported chain IDs.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/update

StatusHTTP CodeDescription
INVALID_NAME400The app name is invalid. It should be between 1 and 64 characters long.
INVALID_DISPLAY_NAME400The display name is invalid. It should be between 1 and 64 characters long.
INVALID_URL400The logo URL is not a valid URL string.
INVALID_COLOR400The provided color is not in a valid format. It should be a valid RGB color code in hex format (e.g. #FA2323).
INVALID_ORIGIN400One of the origins is not in a valid format.
INVALID_REQUEST400The request is not valid e.g. if the request json has unsupported fields.
INVALID_POLICY_MISSING_ADMIN400The policy quorum is invalid because it's missing the account admin.
INVALID_QUORUM_MEMBER_SOL_ADDRESS400The policy quorum member type is SOL_ADDRESS but the public key is not a valid SOL address.
INVALID_POLICY400The policy is invalid.
FORBIDDEN_BY_POLICY403The action is forbidden by the app policy.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

/v2/app/list

StatusHTTP CodeDescription
APP_ID_FILTER_LIST_TOO_LONG400The number of app IDs in the filter list exceeds the maximum allowed limit of 20.
SOMETHING_WENT_WRONG500An unknown error occurred. Please get in touch with us if you continue seeing this error.

© Copyright 2024, Passbird Research Inc.