Momentum AMS REST API: Search Insureds

Base Endpoint

https://api.nowcerts.com/api/InsuredList()

You will need an API access token (see the API Authentication Guide for details) and must include it in your request headers:

Authorization: Bearer {access_token}

1. Get All Insureds

Returns a complete list of insured records.

GET https://api.nowcerts.com/api/InsuredList()

Note: Include the () after InsuredList—it is required.

2. Get a Single Insured by ID

Returns details for one insured by GUID (no quotes inside the parentheses).

GET https://api.nowcerts.com/api/InsuredList({id})

Example:

GET https://api.nowcerts.com/api/InsuredList(49C456A3-9044-4716-B9D8-0075FAEADA33)

3. Select Specific Fields

Retrieve only certain properties from the insured record.

GET https://api.nowcerts.com/api/InsuredList()?$select=id,firstName,addressLine1,phone

View all available properties in the metadata model:
https://api.nowcerts.com/api/$metadata#InsuredList

4. Filter Results

Use $filter to return only insureds that match specific criteria.

GET https://api.nowcerts.com/api/InsuredList()?$filter=firstName eq 'Scott'

Other examples:

GET https://api.nowcerts.com/api/InsuredList()?$filter=EMail eq 'scott.miller@gmail.com' GET https://api.nowcerts.com/api/InsuredList()?$filter=city eq 'New York' GET https://api.nowcerts.com/api/InsuredList()?$filter=city eq 'New York' and lastName eq 'Miller'

5. Order Results

Sort results by a specific field.

GET https://api.nowcerts.com/api/InsuredList()?$orderby=commercialName

For descending order:

GET https://api.nowcerts.com/api/InsuredList()?$orderby=commercialName desc

6. Paging Results

Use $skip and $top to paginate results (always combine with $orderby).

GET https://api.nowcerts.com/api/InsuredList()?$skip=0&$top=5&$orderby=commercialName desc

7. Combine Parameters

You can combine $select, $filter, $orderby, $skip, and $top by joining them with &.

GET https://api.nowcerts.com/api/InsuredList()?$select=id,firstName,addressLine1,phone,city&$orderby=firstName desc&$filter=city eq 'New York'&$skip=0&$top=20

8. Select Specific Fields for a Single Insured

When querying a single insured by ID, you can still limit the returned properties:

GET https://api.nowcerts.com/api/InsuredList(49C456A3-9044-4716-B9D8-0075FAEADA33)?$select=id,firstName,addressLine1,phone,city

9. View Metadata

The metadata endpoint provides the full model description in XML format:

GET https://api.nowcerts.com/api/$metadata#InsuredList

Developer Reference

A working example of building insured search URLs is available in our sample application here:
SearchInsureds.aspx on GitHub