status codes

Response will have one of the following status codes.

Code Description
200 Success -- requested resource is in the response.
201 Success -- the newly created resource is in the response.
400 Bad Request -- could not be understood by the server. API Call failed.
Possible reasons:
  • Requested method or operation is not implemented (e.g. trying to do a POST for an endpoint that does not support a POST)
  • Unhandled Exception - an exception thrown by the API that the code is not handling. Contact GoldStar so that we can investigate.
401 Unauthorized - requested resource requires authentication.
Error Code 80000 - Unauthorized Access to Account
Error Code 80002 - Unauthorized Access to Account - Account is NOT setup for Crowdfunding (Can occur for any of the API calls below
Error Code 89999 - Unauthorized Access to API. Missing credentials. Can occur for any of the API calls below:
  • Create Account
  • Get Account
    • Error Code 80003 - Unauthorized Access to Account - Unauthorized Access to Account - Account is not associated with Portal/Escrow.
  • Get Account with Assets
    • Error Code 80003 - Unauthorized Access to Account - Unauthorized Access to Account - Account is not associated with Portal/Escrow.
  • Get Account with Assets using asset_id
    • Error Code 80003 - Unauthorized Access to Account - Unauthorized Access to Account - Account is not associated with Portal/Escrow.
  • Get Account with Transactions
    • Error Code 80003 - Unauthorized Access to Account - Unauthorized Access to Account - Account is not associated with Portal/Escrow.
  • Get Transaction using transaction_id
  • Fund Account
    • 80001 - Unauthorized access to Account - Account setup has not passed CIP
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
  • Fund Escrow
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
  • Fund Deb Escrow
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
  • Reinvest Debt
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
  • Update Account
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
  • Withdraw Funds
    • Error code 80003 - Unauthorized Access to Account – Unauthorized Access to Account - Account is not associated with Portal/Escrow
404 Not Found - 10000 -requested resource does not exist on the server.
  • Get Investor
  • Get Account
  • Get Account with Assets
  • Get Account with Assets using asset_id
  • Get Account with Transactions
  • Get Transaction using transaction_id
  • Fund Account
  • Fund Escrow
  • Fund Deb Escrow
  • Create Account - additional possible reasons
    • Investor record not found using investor_id provided in the model
    • Bank routing number invalid. Unable to find bank record
  • Update Account
    • Investor record not found using investor_id provided in the model.
  • Reinvest Debt
    • Asset not found with provided id
409 Validation Error
  • Create Investor - 200000 - Investor with the same tax id already exists
  • Fund Escrow - numeric error code with error message returned in response
    • 85000 - Unauthorized Transaction - Account does not have sufficient funds for transaction (available funds)
  • Fund Debt Escrow - numeric error code with error message returned in response
    • 86000 - Escrow is not set up as Debt Offering - Please contact GoldStar Trust
    • 86001 - Invalid Operation - Escrow is not set up as Debt Offering - Please contact GoldStar Trust
  • Reinvest Debt - numeric error code with error message returned in response
    • 86000 - Fund Escrow not set up correctly - Please contact GoldStar Trust
    • 86001 - Invalid Operation - Fund Escrow not set up correctly - Please contact GoldStar Trust
    • 86002 - Invalid Transaction - Amount must equal zero or cost basis amount - This is when activity_code = 707
    • 86003 - Invalid Transaction - Amount must be less than cost basis amount - This occurs when activity_code = 708
    • 86004 - Invalid Transaction - Asset is not active
  • Withdraw Funds - numeric error code with error message returned in response
    • 10006 - Withdraw funds Transaction failed - Please call GoldStar Trust
    • 85000 - Unauthorized Transaction - Account does not have sufficient funds for transaction (Available Balance)
    • 85001 - Unauthorized Transaction - Account does not have a bank account set up
    • 86000 - Fund Escrow not set up correctly - Please call GoldStar Truse
  • Equity Pay - numeric error code with error message returned in response
    • 10007 - Equity Pay Transaction Failed - Please contact GoldStar Trust
    • 86006 - Invalid Operation - Escrow is not set up as Equity Offering - Please contact Goldstar Trust
500 Internal Server Error - Generic error occurred on the server. - API call failed. Can occur with any API call