Country Resource

← Developer Portal: API v2
In Surpass certain resources can be assigned countries and counties, an example being the Centre resource. The request model expects an ID for this and due to the large number of countries and counties available the Surpass API provides two separate resources to get this information rather than documenting the individual ids and descriptions. This effectively acts as a lookup table that can be used within someone's integration process or used once during setup to gather and store required ids. Surpass will not actively change these values so both methods will work in your end to end integration with Surpass.  

Country Resource

Below we have listed the operations, HTTP verbs and an example URL for the Country resource within the Surpass API.
Operation HTTP Verb Example URL
List GET https://...surpass.com/api/v2/Country
Filter GET https://...surpass.com/api/v2/Country?$filter=contains(name, 'Eng')
Read (Individual by ID) GET https://...surpass.com/api/v2/Country/{id}

Attributes for the Country Resource

In the table below we have provided all of the attributes included in the Country Resource. This includes: the attribute name, data type, description, if the attribute is orderable when requesting the GET method and if the attribute is available to filter when requesting the GET method.
Attribute Name Type Description Filter (GET) Available Operators Unique Identifier
id int The unique identifier for the country. This is required when adding a country for other resources. X
X
href string The link to call the individual Country resource.
name string The name of the country in Surpass.  X eq, contains
counties resource A collection of counties that relate to the country specified in the request.

GET Request and Return

The GET Country resource can be called directly by browsing to the URL. Any required parameters such as $filter, $orderBy, $skip and $top would need to form part of the URL that is sent. Below we have provided examples of JSON and XML responses that would be returned from the Surpass API when requesting the GET method for the Country resource. It is important to remember that the return information will be included within the response object that forms part of the standard GET response; this is detailed in the page "Understanding the Surpass API".

Example GET request & response (JSON)
Example GET request & response (XML)

Developer Portal: API v2

  1. Surpass API v2 - Introduction
  2. Using the Surpass API
  3. Centre Resource
  4. Subject Resource
  5. User Resource
  6. Candidate Resource
  7. TestSchedule Resource
  8. Result Resource
  9. TestSession Resource
  10. Exporting Candidate Interactions
  11. Exporting System Specification for Test Delivery machines
  12. SummaryResult Resource
  13. Report Resource
  14. Token Resource
  15. Permission Resource
  16. UserPermission Resource
  17. CentreSubjectAssociation Resource
  18. TagCategory Resource
  19. TagGroup Resource
  20. TagValue Resource
  21. ItemTagValue Resource
  22. Media Resource
  23. Folder Resource
  24. Item Resource
  25. Item List Resource
  26. BasicPage Resource
  27. TestProfile Resource
  28. Test Resource
  29. TestForm Resource
  30. AnalyticsResult Resource
  31. HistoricalResult Resource
  32. Item Response Resource
  33. RescoringRule Resource
  34. Scale Score Mapping Resources
  35. ItemSet Resource
  36. Country Resource
  37. County Resource
  38. Task Resource
  39. MediaGroup Resource
  40. Surpass API v2 - Error Codes
  41. Extended Matching Item Resource
  42. GET/{id} - Item Extended Matching - JSON Example
  43. GET/{id} - Item Extended Matching - XML Example

Feedback and Knowledge Base

(thinking…)