Federated Hermes REST API

Documentation for our web services can be found in the following links:

Federated Hermes Fund API

Federated Hermes Content API

Federated Hermes User API


  1. How do I authenticate?
  2. In order to authenticate, you will need to get a user name and password from Federated Hermes (please use the contact us section to request authentication). Once you have the requested information, you can authenticate in the fund service, content service, or user service authentication web pages. Enter the user name and password and a token will be generated. The token is used to authenticate against the service.

  3. Can I get a CSV file?
  4. The ability to receive a CSV (comma separate value) file from the service is no longer available. Please read the rest of the FAQ for information on formats that are available or review the API documentation.

  5. What is a RESTful API?
  6. A RESTful API is an application program interface (API) that uses HTTP requests to GET, PUT, POST and/or DELETE data. Please read the API documentation to better understand which requests are available.

  7. What is the difference between JSON and XML?
  8. JSON and XML are different means of transferring data. JSON (JavaScript Object Notation) is commonly used with websites since is facilitates asynchronous browser communication. JSON consists of attribute-value pairs and array data types. XML (Extensible Markup Language) is a mark-up language that defines a set of rules for encoding documents. Either will allow the end user to retrieve data but it is a matter of preference on which one to use.

  9. How do I construct my request?
  10. In order to call the API, you will need to authenticate. Please use the contact us section of the website to request authentication information. Once you have the requested information, please issue a request to receive a token (see FAQ #1). Once the token is present, you can request individual objects from the API which will return the data. To test each service, go to the fund service, content service, or user service test URLs. Enter the URL with the API you wish to call, the token you received and pick the format. After clicking submit, you will receive the data from the API in either JSON or XML format.

  11. Who should be using the API?
  12. In general, a developer would request the API to return the data. The data can then be manipulated to be used in a manner that is required by the caller (data storage, etc.). For additional questions, please contact us.

  13. What are the default values returned?
  14. Please see the documentation in each API. Each API will describe the data that is returned by default.

  15. Token time limit
  16. The tokens will expire after a certain amount of time. For anonymous authenticated tokens, the time limit is 5 minutes. For public authenticated tokens, 60 minutes. And finally, for private authenticated tokens, the time limit is 240 minutes.