MyHome.ie Data Delivery Service

<back to all web services

GetLocality

Requires Authentication
The following routes are available for this service:
GET/locality/{LocalityId}
GetLocality Parameters:
NameParameterData TypeRequiredDescription
LocalityIdpathintNo
BaseDeliveryRequest Parameters:
NameParameterData TypeRequiredDescription
SessionIdformstringNo
BaseRequest Parameters:
NameParameterData TypeRequiredDescription
ApiKeyformstringNo
CorrelationIdformstringNo
ActiveUserIdformint?No
VersionformdoubleNo
RequestTypeIdformintNo
LocalityResponse Parameters:
NameParameterData TypeRequiredDescription
LocalityformLocalityNo
LocalityParentsformList<Locality>No
Locality Parameters:
NameParameterData TypeRequiredDescription
LocalityIdformintNo
NameformstringNo
DisplayNameOverrideformstringNo
UrlSlugformstringNo
CodeformstringNo
LatitudeformdoubleNo
LongitudeformdoubleNo
DescriptionformstringNo
NoIndexformboolNo
MapZoomformintNo
TopSpotAvailableformboolNo
ParentIdsformList<int>No
ChildIdsformList<int>No
CreatedOnformDateTimeNo
UseParentStatsformboolNo
Radiusformint?No
LocalityImagesformList<LocalityImage>No
LocalitySeoformList<LocalitySeo>No
LocalityImage Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
LocalityIdformintNo
ImagePathformstringNo
FilenameformstringNo
PathToOriginalformstringNo
PathToGalleriaformstringNo
CaptionformstringNo
SourceformstringNo
LocalitySeo Parameters:
NameParameterData TypeRequiredDescription
LocalityIdformintNo
PropertyClassIdformintNo
MetaDescriptionformstringNo
MetaTitleformstringNo
PageNameformstringNo
CustomDescriptionformstringNo
PropertyTypeIdformintNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /locality/{LocalityId} HTTP/1.1 
Host: agentapi.myhome.ie 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Locality: 
	{
		LocalityId: 0,
		Name: String,
		DisplayNameOverride: String,
		UrlSlug: String,
		Code: String,
		Latitude: 0,
		Longitude: 0,
		Description: String,
		NoIndex: False,
		MapZoom: 0,
		TopSpotAvailable: False,
		ParentIds: 
		[
			0
		],
		ChildIds: 
		[
			0
		],
		CreatedOn: 0001-01-01,
		UseParentStats: False,
		Radius: 0,
		LocalityImages: 
		[
			{
				Id: 0,
				LocalityId: 0,
				ImagePath: String,
				Filename: String,
				PathToOriginal: String,
				PathToGalleria: String,
				Caption: String,
				Source: String
			}
		],
		LocalitySeo: 
		[
			{
				LocalityId: 0,
				PropertyClassId: 0,
				MetaDescription: String,
				MetaTitle: String,
				PageName: String,
				CustomDescription: String,
				PropertyTypeId: 0
			}
		]
	},
	LocalityParents: 
	[
		{
			LocalityId: 0,
			Name: String,
			DisplayNameOverride: String,
			UrlSlug: String,
			Code: String,
			Latitude: 0,
			Longitude: 0,
			Description: String,
			NoIndex: False,
			MapZoom: 0,
			TopSpotAvailable: False,
			ParentIds: 
			[
				0
			],
			ChildIds: 
			[
				0
			],
			CreatedOn: 0001-01-01,
			UseParentStats: False,
			Radius: 0,
			LocalityImages: 
			[
				{
					Id: 0,
					LocalityId: 0,
					ImagePath: String,
					Filename: String,
					PathToOriginal: String,
					PathToGalleria: String,
					Caption: String,
					Source: String
				}
			],
			LocalitySeo: 
			[
				{
					LocalityId: 0,
					PropertyClassId: 0,
					MetaDescription: String,
					MetaTitle: String,
					PageName: String,
					CustomDescription: String,
					PropertyTypeId: 0
				}
			]
		}
	]
}