Dealer Radius Assign OData API


The Dealer Radius Assign API provides third-party websites a way to assign radius to dealers. Radius is used to determine the size of the dealer's lead routing area. This assigned dealer radius overrides the default radius for your Aimbase instance for the dealer/brand combination specified in the post.

Possible Response Codes

  • 200 (OK). This request was successful. The radius was assigned to the dealer or the radius was already assigned to a dealer.
  • 404 (Not Found). The dealer in the URL was not able to be found. 
  • 500 (Internal Server Error). The request was malformed, the dealer given in the request did not exist, or some other unspecified error occurred when attempting to retrieve dealer information.


The Dealer Radius API requires authentication. The HTTP POST will require a valid Authenticate message header with an API token. See the Aimbase Authentication Web Service Specification for more details on how to retrieve a valid API token. 

Authenticate message header example:

Authenticate: Avala-Api {username}:{token}

Post Information

HTTP Endpoint 


Dealer Radius Assign Data Schema

Field Name






Max Length: 50

Number Value.



Max Length: 50

A valid Brand Id in the system.

XML Example Post

Authenticate: Avala-Api {your authentication token}
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" ?>

JSON Example Post

Authenticate: Avala-Api {your authentication token}
Content-Type: application/json
  "BrandId": 1,
  "Radius": 10