Calico®
v1
  • v2
  • v1
API Reference
getCalico.com
API Reference
getCalico.com
v1
  • v2
  • v1
v1
  • v2
  • v1
  1. Resources
  • Getting Started
  • Calico Connect
  • Use Cases
  • Overview
  • Platform API
    • Authentication
    • OAuth
      • Authorization Callback
    • Providers
      • Add providers
      • List providers
      • Remove providers
    • Assets
      • User assets
      • Refresh asset list
    • Transactions
      • Transactions
      • Refresh transactions
  • Resources
    • Response codes
    • FAQs
  • Schemas
    • Schemas
      • OpenAPIIntegrationResponse
      • CalicoErrorResponse
      • RefreshResponse
      • CryptoSourceId
      • OpenAPIAssetPosition
      • CryptoSourceCredentialAuthType
      • Add Crypto Source
      • Add Crypto Source Response
      • CryptoSourceDescriptor
      • OpenAPIDeleteCryptoSourceRequest
      • number
      • OpenAPIGetConsentURLForThirdPartyResponse
      • TransactionType
      • OpenAPITransactionCategorization
      • OpenAPIFeeItem
      • OpenAPIFeeObject
      • OpenAPICurrencyValue
      • Input only transactions
      • Transactions data
      • Send transaction data
      • Output only transaction data
      • Receive transaction data
      • Transactions with input and output
      • Uncategorized transaction data
API Reference
getCalico.com
API Reference
getCalico.com
v1
  • v2
  • v1
v1
  • v2
  • v1
  1. Resources

Response codes

Response codes are returned when interacting with our platform. These codes indicate whether your request was successful or had an error.

Successful Responses#

CodeDescriptionSuggested Fix
201OK; The request has succeeded.No action needed. Confirm the response content matches expectations
202Created: The request has been fulfilled and resulted in a new source.No action needed. Use the returned resource ID or location if applicable.
206Partial Content: One or more requested crypto sources is down.Retry the request later to notify the user about partial data availability.

Client Error Codes#

CodeDescriptionSuggested Fix
400Bad Request: Input does not satisfy API specification.Validate request parameters and payload against the API documentation.
401Unauthorized: Missing or invalid authentication credentials.Ensure the access token is valid and included in the Authorization header.
403Forbidden: Insufficient rights to access the resource.Verify user permissions and requested scopes.
404Not Found: The requested resource does not exist.Check the resource ID or endpoint URL for correctness.
429Too Many Requests: Rate limit exceeded.Implement exponential backoff and retry logic. Monitor and respect rate limits.

Server Error Codes#

CodeDescriptionSuggested Fix
500Internal Server Error: Unexpected server issue.Retry after a delay. If persistent, contact Calico support.
501Not Implemented: Required subsystem unavailable.Retry later or contact Calico support for system status.
503Service Unavailable: Scheduled maintenance.Retry after the maintenance window.

End User Error Codes#

CodeDescriptionSuggested Fix
601Customer Not Found: The specified customer does not exist.Verify the customer ID or identifier used in the request.
602Customer Not Authorized: Action not permitted for this customer.Confirm the customer has the necessary permissions or entitlements.
603Authentication Failed: Invalid credentials or session.Prompt the user to re-authenticate. Check for expired or revoked tokens.
701Account Not Found: The specified account does not exist.Validate the account ID or ensure the account is linked to the user.
702Invalid Start or End Date: Date format or logic error.Ensure dates are in the correct format and within supported ranges.
703Invalid Date Range: Start date is not earlier than end date or unsupported.Adjust the date range to meet API requirements.
Previous
Refresh transactions
Next
FAQs