POST /

Submits a new search order using the PISCES v2 XML format. This endpoint is intended for sending ForwardSearchOrderSend messages.

Sandbox Base URL: Provided on integration setup.

Base URL: Provided on integration setup.

Authentication required. Pass your API key inside the XML body in <AuthenticationKey> (or <Password> for username/password auth).

Endpoint

POST /

Content-Type: text/xml or application/xml

Request Body

A SOAP envelope containing a ForwardSearchOrderSend message, as defined by the OSCRE SRCH-Version-02 schema.

Authentication

Authenticate using either an API key or username/password inside <AuthenticationData>:

<!-- API key -->
<AuthenticationData>
  <AuthenticationKey>YOUR_API_KEY</AuthenticationKey>
</AuthenticationData>

<!-- Username / password -->
<AuthenticationData>
  <Username>your-username</Username>
  <Password>your-password</Password>
</AuthenticationData>

Site address

Supply the site as a PAF address, or as an address line. The coordinates use British National Grid (Easting/Northing).

PAF address

<SubjectProperty>
  <PAFAddress>
    <BuildingNumber>69</BuildingNumber>
    <ThoroughfareName>Thoroughfare</ThoroughfareName>
    <DependantLocality>Locality</DependantLocality>
    <PostTown>Town</PostTown>
    <PostCode>AR12 8RZ</PostCode>
  </PAFAddress>
  <!-- Site location, see below -->
</SubjectProperty>

Address line

<SubjectProperty>
  <AddressLine>
    <Line>69 Ramsay Street</Line>
    <Line>Scranton</Line>
    <Line>AB12 1FX</Line>
  </AddressLine>
  <!-- Site location, see below -->
</SubjectProperty>

Site location

The location can be passed as either a Polygon or a Point. Of course a polygon should be preferred where possible.

Polygon

<SubjectProperty>
  <!-- Site address, see above -->
  <PolygonList>
    <Polygon>
      <Point>
        <SequenceNumeric>0</SequenceNumeric>
        <EastingNumeric>532632</EastingNumeric>
        <NorthingNumeric>184834</NorthingNumeric>
      </Point>
      <!-- additional points... -->
    </Polygon>
  </PolygonList>
</SubjectProperty>

Point

<SubjectProperty>
  <!-- Site address, see above -->
  <Point>
    <SequenceNumeric>0</SequenceNumeric>
    <EastingNumeric>477564</EastingNumeric>
    <NorthingNumeric>266073</NorthingNumeric>
  </Point>
</SubjectProperty>

Products

One or more <SearchProduct> elements. <ProductType> must be a valid product code (resi_core, resi_pro, resi_ultra).

An optional product reference can be associated to the product within <Reference>. If one is not specificed then we will generate one on your behalf.

<SearchProduct>
  <ProductType>resi_core</ProductType>
  <SearchProductReference>
    <Reference>YOUR-REFERENCE</Reference>
    <AllocatedBy>SearchRequesterParty</AllocatedBy>
    <Description>Optional description</Description>
  </SearchProductReference>
</SearchProduct>

Order references

<SearchFacilitatorParty> is mandatory and should contain the reference you wish to supply. <SearchRequesterParty> is optional, and is typically used to carry your end customer's reference.

Full example

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <ForwardOrder xmlns="http://geocerta.io/services">
      <ForwardSearchOrderSend xmlns="http://www.oscre.org/ns/SRCH-Version-02/OS/ForwardSearchOrderSend">
        <Authentication xmlns="http://www.oscre.org/ns/v1/piscesauthentication">
          <Header>
            <Version>2.0</Version>
            <Mode>Live</Mode>
          </Header>
          <AuthenticationData>
            <AuthenticationKey>YOUR_API_KEY</AuthenticationKey>
          </AuthenticationData>
        </Authentication>
        <SearchOrder>
          <SearchOrderDate>2026-01-15</SearchOrderDate>
          <SearchOrderReference>
            <Reference>YOUR-ORDER-REF</Reference>
            <AllocatedBy>SearchRequesterParty</AllocatedBy>
            <Description />
          </SearchOrderReference>
          <SearchOrderReference>
            <Reference>FACILITATOR-REF</Reference>
            <AllocatedBy>SearchFacilitatorParty</AllocatedBy>
            <Description />
          </SearchOrderReference>
          <SubjectProperty>
            <PAFAddress>
              <BuildingNumber>12</BuildingNumber>
              <ThoroughfareName>Thoroughfare</ThoroughfareName>
              <PostTown>Town</PostTown>
              <PostCode>AR12 8RZ</PostCode>
            </PAFAddress>
            <PolygonList>
              <Polygon>
                <Point>
                  <SequenceNumeric>0</SequenceNumeric>
                  <EastingNumeric>532632</EastingNumeric>
                  <NorthingNumeric>184834</NorthingNumeric>
                </Point>
                <!-- additional points... -->
              </Polygon>
            </PolygonList>
          </SubjectProperty>
          <SearchProduct>
            <ProductType>resi_core</ProductType>
            <SearchProductReference>
              <Reference>PRODUCT-REFERENCE</Reference>
              <AllocatedBy>SearchRequesterParty</AllocatedBy>
            </SearchProductReference>
          </SearchProduct>
        </SearchOrder>
      </ForwardSearchOrderSend>
    </ForwardOrder>
  </soap:Body>
</soap:Envelope>

Response

200 OK — order accepted. Returns a ForwardSearchOrderSendAcknowledgeType XML body containing the Geocerta order reference and a reference per product.

<ForwardSearchOrderSendAcknowledgeType
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SearchOrderReference xmlns="http://www.oscre.org/ns/SRCH-Version-02/OS/ForwardSearchOrderSendAcknowledge">
    <Reference>GC-2024-001234</Reference>
    <AllocatedBy>Geocerta</AllocatedBy>
    <Description>Order ID: 66f3a1b2c4e5d8f9a1b2c4e5</Description>
  </SearchOrderReference>
  <SearchProductReference xmlns="http://www.oscre.org/ns/SRCH-Version-02/OS/ForwardSearchOrderSendAcknowledge">
    <Reference>GC-PROD-001</Reference>
    <AllocatedBy>SearchFacilitatorParty</AllocatedBy>
    <Description>Product id: 66f3a1b2c4e5d8f9a1b2c4e6</Description>
  </SearchProductReference>
</ForwardSearchOrderSendAcknowledgeType>

Errors

Errors are returned as ForwardSearchOrderSendRejectType XML bodies.

<ForwardSearchOrderSendRejectType
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <SearchOrderReference xmlns="http://www.oscre.org/ns/SRCH-Version-02/OS/ForwardSearchOrderSendReject">
    <Reference>YOUR-ORDER-REF</Reference>
    <AllocatedBy>Geocerta</AllocatedBy>
    <Description>CaseFileReference</Description>
  </SearchOrderReference>
  <RejectionResponse xmlns="http://www.oscre.org/ns/SRCH-Version-02/OS/ForwardSearchOrderSendReject">
    <Code>400</Code>
    <Reason>Invalid product code</Reason>
    <OtherDescription />
  </RejectionResponse>
</ForwardSearchOrderSendRejectType>
HTTP Status Code Cause
400 400 Malformed XML or invalid field values
401 401 Missing or invalid API key
404 404 Referenced resource not found
500 500 Unexpected server error