POST api/VesselsByName

Returns any records matching the search criteria provided.

Request Information

URI Parameters

None.

Body Parameters

The parameters for the search

VesselsByNamePostParameters

Name	Description	Type	Additional information
Name	The string to search the Name field for. * wildcards allowed. Case insensitive.	string	Required Min length: 3

Name

Description

Type

Additional 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

Name	Description	Type	Additional 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": "3b08f0bd-f6d1-4473-973a-124a1e3caa4d",
      "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": "3b08f0bd-f6d1-4473-973a-124a1e3caa4d",
      "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": "3b08f0bd-f6d1-4473-973a-124a1e3caa4d",
      "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": "3b08f0bd-f6d1-4473-973a-124a1e3caa4d",
      "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>3b08f0bd-f6d1-4473-973a-124a1e3caa4d</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>3b08f0bd-f6d1-4473-973a-124a1e3caa4d</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>3b08f0bd-f6d1-4473-973a-124a1e3caa4d</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>3b08f0bd-f6d1-4473-973a-124a1e3caa4d</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>