Using cURL for Verato APIs

What is cURL?

Client URL (cURL) is a command line tool that enables data exchange between a device and a server through a terminal. Using this command line interface (CLI), a user specifies a server URL (the location where they want to send a request) and the data they want to send to that server URL.

What it means for Verato?

Basically it is a way to call Verato APIs using terminal instead of Postman or SoapUI.

Use Cases

Customers can leverage the cURL command in the following scenarios:

  • If you are not able to install applications like Postman in the integration layer/infrastructure and instead want to use terminal commands for calling APIs.
  • If you want a quick and easy way to access APIs at the command line level for quick tests that doesn’t require the full installation of Postman, SoapUI, etc.


  • Username
  • Password
  • Certificate
  • Certificate password
  • IPs must be added to Verato’s allowed list
  • URL


curl --cert <.cer cert> --key <.pem cert> --user 'api_user':'api_password' --url<request_type> --data '<request_body>'



curl --cert verato.customer.service.cer --key verato.customer.service.pem --user user:password --url --data '{"trackingId":"","content":{"responseIdentityFormatNames":["DEFAULT"],"source":{"name":"epic.demo","id":"987456"}}}'

Successful Response

{"success":true,"message":"Could not find entity with nativeId 987456 and source epic.demo","content":{},"trackingId":"","auditId":"6bb68155-7aac-43a7-ad38-880fe14a20a5","retryableError":false}


In newer versions of Postman, you can easily convert a postman request into a curl command using the following technique:

The Postman version in the screenshots below is Version 8.12.4.
  1. Request Body on Postman:
  2. On the right, click the code option </>, and select cURL.image-20230927-165400.pngRemember to add credential details along with the cURL command on the right for a succesful API call.

Potential Errors

  • If your password contains special characters include it in quotes 'password'. You might receive the following error message: - bash: xxxpasswordxx: event not found
  • If the password is incorrect, you will receive a 401 - Unauthorized error message:
  • If the URL is incorrect, you will receive the following error message: