Handling Spaces in Queries

Request URLs must be URL-encoded. In practice this means that spaces in URL query values must be replaced with ‘+’ and the @ symbol must be replaced with ‘%40’.

  • GOOD: ?search=New+York+City&start=1&limit=10
  • BAD: ?search=New York City&start=1&limit=10

HTTP will truncate the “”BAD”” query at the space after the word “New”, so you will receive 25 records (the default limit) matching only the word “New”.

(Note that the Active Docs found on the Developer Portal will do the URL-encoding for you. In the Active Docs for Get Institutions, you would enter “”New York City”” in the field for the search parameter.)