POST Api/v{apiVersion}/Coverages

Creates a new coverage

Request Information

URI Parameters

Name	Description	Type	Additional information
apiVersion		string	None.

Body Parameters

CoverageValues

Name	Type	Additional information
MediumID	globally unique identifier	None.
AreaID	globally unique identifier	None.
Type	CoverageType	None.
Value	decimal number	None.
Status	CoverageStatus	None.
Notes	string	None.

Request Formats

application/json, text/json

Sample:

{
  "MediumID": "107a2ce3-0ed6-4188-87a1-4dad8461aac2",
  "AreaID": "cf14a93b-04c8-46cd-87ef-a5c9fe2b3a30",
  "Type": "GeneralAvailable",
  "Value": 1.1,
  "Status": "InActive",
  "Notes": "sample string 2"
}

application/xml, text/xml

Sample:

<CoverageValues xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <AreaID>cf14a93b-04c8-46cd-87ef-a5c9fe2b3a30</AreaID>
  <MediumID>107a2ce3-0ed6-4188-87a1-4dad8461aac2</MediumID>
  <Notes>sample string 2</Notes>
  <Status>InActive</Status>
  <Type>GeneralAvailable</Type>
  <Value>1.1</Value>
</CoverageValues>

application/x-www-form-urlencoded

Sample:

Sample not available.

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="MediumID"

107a2ce3-0ed6-4188-87a1-4dad8461aac2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="AreaID"

cf14a93b-04c8-46cd-87ef-a5c9fe2b3a30
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Type"

GeneralAvailable
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Value"

1.1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e--

Response Information

Resource Description

CoverageDetails

Name	Type	Additional information
CoverageID	globally unique identifier	None.
Medium	MediumPreview	None.
Area	AreaPreview	None.
Type	CoverageType	None.
Value	decimal number	None.
Status	CoverageStatus	None.
DataCopyright	string	None.
Notes	string	None.
CreatedAt	date	None.
CreatedBy	string	None.
ModifiedAt	date	None.
ModifiedBy	string	None.

Response Formats

application/json, text/json

Sample:

{
  "CoverageID": "2c6c1d89-610f-4ecb-a635-d00096f5b8f9",
  "Medium": {
    "MediumID": "8df53d2b-ad09-4736-a8cf-498d619aec00",
    "Supplier": {
      "SupplierID": "7aba4518-4087-4840-b91b-10612475249e",
      "ParentName": "sample string 2",
      "Name": "sample string 3",
      "Status": "InActive",
      "IsBackendSupplier": true,
      "Contact": "sample string 5",
      "PhoneNumber": "sample string 6"
    },
    "Category": {
      "CategoryID": "a4bb6224-be27-4f1a-94ed-ab3e6207eaa6",
      "MediumType": "Print",
      "Name": "sample string 2",
      "Status": "InActive"
    },
    "Name": "sample string 2",
    "Type": "Print",
    "SpreadType": "AdLocations",
    "Status": "InActive"
  },
  "Area": {
    "AreaID": "4632abd7-5e89-4171-8c00-5f1a17c4b791",
    "ParentID": "a34cbadc-aa5f-4298-a679-1934aae6713c",
    "ParentName": "sample string 2",
    "SupplierName": "sample string 3",
    "CustomerName": "sample string 4",
    "StoreName": "sample string 5",
    "Code": "sample string 6",
    "Name": "sample string 7",
    "Type": "Neighbourhood",
    "Status": "InActive",
    "OwnerName": "sample string 8",
    "Population": 9,
    "Mailboxes": 10
  },
  "Type": "GeneralAvailable",
  "Value": 2.1,
  "Status": "InActive",
  "DataCopyright": "sample string 3",
  "Notes": "sample string 4",
  "CreatedAt": "2026-01-15T13:45:22.3017043Z",
  "CreatedBy": "sample string 6",
  "ModifiedAt": "2026-01-15T13:45:22.3017043Z",
  "ModifiedBy": "sample string 8"
}

application/xml, text/xml

Sample:

<CoverageDetails xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Hier.Api.ViewModels">
  <Area>
    <AreaID>4632abd7-5e89-4171-8c00-5f1a17c4b791</AreaID>
    <Code>sample string 6</Code>
    <CustomerName>sample string 4</CustomerName>
    <Mailboxes>10</Mailboxes>
    <Name>sample string 7</Name>
    <OwnerName>sample string 8</OwnerName>
    <ParentID>a34cbadc-aa5f-4298-a679-1934aae6713c</ParentID>
    <ParentName>sample string 2</ParentName>
    <Population>9</Population>
    <Status>InActive</Status>
    <StoreName>sample string 5</StoreName>
    <SupplierName>sample string 3</SupplierName>
    <Type>Neighbourhood</Type>
  </Area>
  <CoverageID>2c6c1d89-610f-4ecb-a635-d00096f5b8f9</CoverageID>
  <CreatedAt>2026-01-15T14:45:22.3017043+01:00</CreatedAt>
  <CreatedBy>sample string 6</CreatedBy>
  <DataCopyright>sample string 3</DataCopyright>
  <Medium>
    <Category>
      <CategoryID>a4bb6224-be27-4f1a-94ed-ab3e6207eaa6</CategoryID>
      <MediumType>Print</MediumType>
      <Name>sample string 2</Name>
      <Status>InActive</Status>
    </Category>
    <MediumID>8df53d2b-ad09-4736-a8cf-498d619aec00</MediumID>
    <Name>sample string 2</Name>
    <SpreadType>AdLocations</SpreadType>
    <Status>InActive</Status>
    <Supplier>
      <Contact>sample string 5</Contact>
      <IsBackendSupplier>true</IsBackendSupplier>
      <Name>sample string 3</Name>
      <ParentName>sample string 2</ParentName>
      <PhoneNumber>sample string 6</PhoneNumber>
      <Status>InActive</Status>
      <SupplierID>7aba4518-4087-4840-b91b-10612475249e</SupplierID>
    </Supplier>
    <Type>Print</Type>
  </Medium>
  <ModifiedAt>2026-01-15T14:45:22.3017043+01:00</ModifiedAt>
  <ModifiedBy>sample string 8</ModifiedBy>
  <Notes>sample string 4</Notes>
  <Status>InActive</Status>
  <Type>GeneralAvailable</Type>
  <Value>2.1</Value>
</CoverageDetails>

multipart/form-data

Sample:

--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CoverageID"

2c6c1d89-610f-4ecb-a635-d00096f5b8f9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.MediumID"

8df53d2b-ad09-4736-a8cf-498d619aec00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.SupplierID"

7aba4518-4087-4840-b91b-10612475249e
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.ParentName"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.Name"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.IsBackendSupplier"

True
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.Contact"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Supplier.PhoneNumber"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Category.CategoryID"

a4bb6224-be27-4f1a-94ed-ab3e6207eaa6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Category.MediumType"

Print
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Category.Name"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Category.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Name"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Type"

Print
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.SpreadType"

AdLocations
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Medium.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.AreaID"

4632abd7-5e89-4171-8c00-5f1a17c4b791
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.ParentID"

a34cbadc-aa5f-4298-a679-1934aae6713c
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.ParentName"

sample string 2
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.SupplierName"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.CustomerName"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.StoreName"

sample string 5
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Code"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Name"

sample string 7
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Type"

Neighbourhood
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.OwnerName"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Population"

9
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Area.Mailboxes"

10
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Type"

GeneralAvailable
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Value"

2.1
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Status"

InActive
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="DataCopyright"

sample string 3
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="Notes"

sample string 4
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CreatedAt"

2026-01-15T14:45:22.3017043+01:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="CreatedBy"

sample string 6
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ModifiedAt"

2026-01-15T14:45:22.3017043+01:00
--MultipartDataMediaFormatterBoundary1q2w3e
Content-Disposition: form-data; name="ModifiedBy"

sample string 8
--MultipartDataMediaFormatterBoundary1q2w3e--