POST api/VesselsByName

Returns any records matching the search criteria provided.

Request Information

URI Parameters

None.

Body Parameters

The parameters for the search

VesselsByNamePostParameters
NameDescriptionTypeAdditional information
Name

The string to search the Name field for. * wildcards allowed. Case insensitive.

string

Required

Min length: 3

Request Formats

application/json, text/json

Sample:
{
  "Name": "sample string 1"
}

application/xml, text/xml

Sample:
<VesselsByNamePostParameters xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Name>sample string 1</Name>
</VesselsByNamePostParameters>

Response Information

Resource Description

VesselsByName
NameDescriptionTypeAdditional information
AISNameResults

The results of the search on the name last transmitted by AIS

Collection of Vessel

None.

CorrectedNameResults

The results of the search on the name as per AIS corrections

Collection of Vessel

None.

Response Formats

application/json, text/json

Sample:
{
  "AISNameResults": [
    {
      "vessel_identifier": "f83511c1-9ee4-435f-953e-199078681f73",
      "name": "sample string 2",
      "imo": "sample string 3",
      "mmsi": "sample string 4",
      "callsign": "sample string 5",
      "flag": {
        "name": "sample string 1",
        "alpha_2_code": "sample string 2",
        "alpha_3_code": "sample string 3",
        "numeric_code": "sample string 4",
        "region": "sample string 5",
        "continent": "sample string 6"
      },
      "ais_type": "sample string 6",
      "type": "sample string 7",
      "sub_type": "sample string 8",
      "dwt": 1,
      "length": 1.0,
      "breadth": 1.0,
      "commercial_owner": "sample string 9",
      "effective_controller": "sample string 10",
      "technical_manager": "sample string 11",
      "financial_owner": "sample string 12",
      "gt": 1,
      "year_of_build": 1
    },
    {
      "vessel_identifier": "f83511c1-9ee4-435f-953e-199078681f73",
      "name": "sample string 2",
      "imo": "sample string 3",
      "mmsi": "sample string 4",
      "callsign": "sample string 5",
      "flag": {
        "name": "sample string 1",
        "alpha_2_code": "sample string 2",
        "alpha_3_code": "sample string 3",
        "numeric_code": "sample string 4",
        "region": "sample string 5",
        "continent": "sample string 6"
      },
      "ais_type": "sample string 6",
      "type": "sample string 7",
      "sub_type": "sample string 8",
      "dwt": 1,
      "length": 1.0,
      "breadth": 1.0,
      "commercial_owner": "sample string 9",
      "effective_controller": "sample string 10",
      "technical_manager": "sample string 11",
      "financial_owner": "sample string 12",
      "gt": 1,
      "year_of_build": 1
    }
  ],
  "CorrectedNameResults": [
    {
      "vessel_identifier": "f83511c1-9ee4-435f-953e-199078681f73",
      "name": "sample string 2",
      "imo": "sample string 3",
      "mmsi": "sample string 4",
      "callsign": "sample string 5",
      "flag": {
        "name": "sample string 1",
        "alpha_2_code": "sample string 2",
        "alpha_3_code": "sample string 3",
        "numeric_code": "sample string 4",
        "region": "sample string 5",
        "continent": "sample string 6"
      },
      "ais_type": "sample string 6",
      "type": "sample string 7",
      "sub_type": "sample string 8",
      "dwt": 1,
      "length": 1.0,
      "breadth": 1.0,
      "commercial_owner": "sample string 9",
      "effective_controller": "sample string 10",
      "technical_manager": "sample string 11",
      "financial_owner": "sample string 12",
      "gt": 1,
      "year_of_build": 1
    },
    {
      "vessel_identifier": "f83511c1-9ee4-435f-953e-199078681f73",
      "name": "sample string 2",
      "imo": "sample string 3",
      "mmsi": "sample string 4",
      "callsign": "sample string 5",
      "flag": {
        "name": "sample string 1",
        "alpha_2_code": "sample string 2",
        "alpha_3_code": "sample string 3",
        "numeric_code": "sample string 4",
        "region": "sample string 5",
        "continent": "sample string 6"
      },
      "ais_type": "sample string 6",
      "type": "sample string 7",
      "sub_type": "sample string 8",
      "dwt": 1,
      "length": 1.0,
      "breadth": 1.0,
      "commercial_owner": "sample string 9",
      "effective_controller": "sample string 10",
      "technical_manager": "sample string 11",
      "financial_owner": "sample string 12",
      "gt": 1,
      "year_of_build": 1
    }
  ]
}

application/xml, text/xml

Sample:
<VesselsByName xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <AISNameResults>
    <Vessel>
      <vessel_identifier>f83511c1-9ee4-435f-953e-199078681f73</vessel_identifier>
      <name>sample string 2</name>
      <imo>sample string 3</imo>
      <mmsi>sample string 4</mmsi>
      <callsign>sample string 5</callsign>
      <flag>
        <name>sample string 1</name>
        <alpha_2_code>sample string 2</alpha_2_code>
        <alpha_3_code>sample string 3</alpha_3_code>
        <numeric_code>sample string 4</numeric_code>
        <region>sample string 5</region>
        <continent>sample string 6</continent>
      </flag>
      <ais_type>sample string 6</ais_type>
      <type>sample string 7</type>
      <sub_type>sample string 8</sub_type>
      <dwt>1</dwt>
      <length>1</length>
      <breadth>1</breadth>
      <commercial_owner>sample string 9</commercial_owner>
      <effective_controller>sample string 10</effective_controller>
      <technical_manager>sample string 11</technical_manager>
      <financial_owner>sample string 12</financial_owner>
      <gt>1</gt>
      <year_of_build>1</year_of_build>
    </Vessel>
    <Vessel>
      <vessel_identifier>f83511c1-9ee4-435f-953e-199078681f73</vessel_identifier>
      <name>sample string 2</name>
      <imo>sample string 3</imo>
      <mmsi>sample string 4</mmsi>
      <callsign>sample string 5</callsign>
      <flag>
        <name>sample string 1</name>
        <alpha_2_code>sample string 2</alpha_2_code>
        <alpha_3_code>sample string 3</alpha_3_code>
        <numeric_code>sample string 4</numeric_code>
        <region>sample string 5</region>
        <continent>sample string 6</continent>
      </flag>
      <ais_type>sample string 6</ais_type>
      <type>sample string 7</type>
      <sub_type>sample string 8</sub_type>
      <dwt>1</dwt>
      <length>1</length>
      <breadth>1</breadth>
      <commercial_owner>sample string 9</commercial_owner>
      <effective_controller>sample string 10</effective_controller>
      <technical_manager>sample string 11</technical_manager>
      <financial_owner>sample string 12</financial_owner>
      <gt>1</gt>
      <year_of_build>1</year_of_build>
    </Vessel>
  </AISNameResults>
  <CorrectedNameResults>
    <Vessel>
      <vessel_identifier>f83511c1-9ee4-435f-953e-199078681f73</vessel_identifier>
      <name>sample string 2</name>
      <imo>sample string 3</imo>
      <mmsi>sample string 4</mmsi>
      <callsign>sample string 5</callsign>
      <flag>
        <name>sample string 1</name>
        <alpha_2_code>sample string 2</alpha_2_code>
        <alpha_3_code>sample string 3</alpha_3_code>
        <numeric_code>sample string 4</numeric_code>
        <region>sample string 5</region>
        <continent>sample string 6</continent>
      </flag>
      <ais_type>sample string 6</ais_type>
      <type>sample string 7</type>
      <sub_type>sample string 8</sub_type>
      <dwt>1</dwt>
      <length>1</length>
      <breadth>1</breadth>
      <commercial_owner>sample string 9</commercial_owner>
      <effective_controller>sample string 10</effective_controller>
      <technical_manager>sample string 11</technical_manager>
      <financial_owner>sample string 12</financial_owner>
      <gt>1</gt>
      <year_of_build>1</year_of_build>
    </Vessel>
    <Vessel>
      <vessel_identifier>f83511c1-9ee4-435f-953e-199078681f73</vessel_identifier>
      <name>sample string 2</name>
      <imo>sample string 3</imo>
      <mmsi>sample string 4</mmsi>
      <callsign>sample string 5</callsign>
      <flag>
        <name>sample string 1</name>
        <alpha_2_code>sample string 2</alpha_2_code>
        <alpha_3_code>sample string 3</alpha_3_code>
        <numeric_code>sample string 4</numeric_code>
        <region>sample string 5</region>
        <continent>sample string 6</continent>
      </flag>
      <ais_type>sample string 6</ais_type>
      <type>sample string 7</type>
      <sub_type>sample string 8</sub_type>
      <dwt>1</dwt>
      <length>1</length>
      <breadth>1</breadth>
      <commercial_owner>sample string 9</commercial_owner>
      <effective_controller>sample string 10</effective_controller>
      <technical_manager>sample string 11</technical_manager>
      <financial_owner>sample string 12</financial_owner>
      <gt>1</gt>
      <year_of_build>1</year_of_build>
    </Vessel>
  </CorrectedNameResults>
</VesselsByName>