GET api/v1/media/ByUniqueName/{name}?start={start}&limit={limit}

Returns all the media items assigned with the unique media name. This acts as a kind of perma-link to a every changing image (e.g. time delayed snapshots)

Request Information

URI Parameters

Name	Description	Type	Additional information
name	UniqueName to filter by	string	Required
start		integer	Default value is 0
limit		integer	Default value is 100

Body Parameters

None.

Response Information

Resource Description

Collection of MediaItemDto

Name	Description	Type	Additional information
Id	Id	globally unique identifier	None.
UserId	Published by this user/member/device	globally unique identifier	None.
ContentType	Content type (png, jpg, etc).	string	None.
Caption	A caption to go with the item. This will be used as status post text if the CreateStatusPost option is set to true	string	None.
Description	Option description to go with the photo	string	None.
UniqueMediaName	A Unique name that is associated with media items. When media is requested using the UniqueMediaName it can show the latest or a stream of the media associated with the name.	string	None.
Location	Location this photo was taken (or of)	LocationDto	None.
Tags	Tags to associate with the photo	Collection of string	None.
Links	List of the links (e.g. self)	Collection of LinkDto	None.
Actions	List of actionable links (e.g. delete)	Collection of LinkDto	None.
DateAdded	When the item was added.	date	None.
LastUpdated	When the item was last updated	date	None.
Private	If this media item is flagged as private to the individual account.	boolean	None.

Response Formats

application/json, text/json, application/senml+json

Sample:

[
  {
    "Id": "878a111f-23af-4644-b96f-4efe4cfa321a",
    "UserId": "9ad96e38-4cf1-4ad1-b715-98fbb59bc1f8",
    "ContentType": "sample string 3",
    "Caption": "sample string 4",
    "Description": "sample string 5",
    "UniqueMediaName": "sample string 6",
    "Location": {
      "Name": "sample string 1",
      "Latitude": 2.1,
      "Longitude": 3.1,
      "Elevation": 4.1,
      "WellKnownLocationId": "b89136c2-b4c4-4251-a78c-b8bd781d1306",
      "LastUpdated": "2025-10-25T17:57:27.5597257+00:00"
    },
    "Tags": [
      "sample string 1",
      "sample string 2"
    ],
    "Links": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ],
    "Actions": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ],
    "DateAdded": "2025-10-25T17:57:27.5597257+00:00",
    "LastUpdated": "2025-10-25T17:57:27.5597257+00:00",
    "Private": true
  },
  {
    "Id": "878a111f-23af-4644-b96f-4efe4cfa321a",
    "UserId": "9ad96e38-4cf1-4ad1-b715-98fbb59bc1f8",
    "ContentType": "sample string 3",
    "Caption": "sample string 4",
    "Description": "sample string 5",
    "UniqueMediaName": "sample string 6",
    "Location": {
      "Name": "sample string 1",
      "Latitude": 2.1,
      "Longitude": 3.1,
      "Elevation": 4.1,
      "WellKnownLocationId": "b89136c2-b4c4-4251-a78c-b8bd781d1306",
      "LastUpdated": "2025-10-25T17:57:27.5597257+00:00"
    },
    "Tags": [
      "sample string 1",
      "sample string 2"
    ],
    "Links": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ],
    "Actions": [
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      },
      {
        "Href": "sample string 1",
        "Rel": "sample string 2",
        "Action": "sample string 3"
      }
    ],
    "DateAdded": "2025-10-25T17:57:27.5597257+00:00",
    "LastUpdated": "2025-10-25T17:57:27.5597257+00:00",
    "Private": true
  }
]

application/xml, text/xml

Sample:

<ArrayOfMediaItemDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Media">
  <MediaItemDto>
    <Actions xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
    </Actions>
    <Caption>sample string 4</Caption>
    <ContentType>sample string 3</ContentType>
    <DateAdded>2025-10-25T17:57:27.5597257+00:00</DateAdded>
    <Description>sample string 5</Description>
    <Id>878a111f-23af-4644-b96f-4efe4cfa321a</Id>
    <LastUpdated>2025-10-25T17:57:27.5597257+00:00</LastUpdated>
    <Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
    </Links>
    <Location xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:Elevation>4.1</d3p1:Elevation>
      <d3p1:LastUpdated>2025-10-25T17:57:27.5597257+00:00</d3p1:LastUpdated>
      <d3p1:Latitude>2.1</d3p1:Latitude>
      <d3p1:Longitude>3.1</d3p1:Longitude>
      <d3p1:Name>sample string 1</d3p1:Name>
      <d3p1:WellKnownLocationId>b89136c2-b4c4-4251-a78c-b8bd781d1306</d3p1:WellKnownLocationId>
    </Location>
    <Private>true</Private>
    <Tags xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Tags>
    <UniqueMediaName>sample string 6</UniqueMediaName>
    <UserId>9ad96e38-4cf1-4ad1-b715-98fbb59bc1f8</UserId>
  </MediaItemDto>
  <MediaItemDto>
    <Actions xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
    </Actions>
    <Caption>sample string 4</Caption>
    <ContentType>sample string 3</ContentType>
    <DateAdded>2025-10-25T17:57:27.5597257+00:00</DateAdded>
    <Description>sample string 5</Description>
    <Id>878a111f-23af-4644-b96f-4efe4cfa321a</Id>
    <LastUpdated>2025-10-25T17:57:27.5597257+00:00</LastUpdated>
    <Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
      <d3p1:LinkViewModel>
        <d3p1:Action>sample string 3</d3p1:Action>
        <d3p1:Href>sample string 1</d3p1:Href>
        <d3p1:Rel>sample string 2</d3p1:Rel>
      </d3p1:LinkViewModel>
    </Links>
    <Location xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared">
      <d3p1:Elevation>4.1</d3p1:Elevation>
      <d3p1:LastUpdated>2025-10-25T17:57:27.5597257+00:00</d3p1:LastUpdated>
      <d3p1:Latitude>2.1</d3p1:Latitude>
      <d3p1:Longitude>3.1</d3p1:Longitude>
      <d3p1:Name>sample string 1</d3p1:Name>
      <d3p1:WellKnownLocationId>b89136c2-b4c4-4251-a78c-b8bd781d1306</d3p1:WellKnownLocationId>
    </Location>
    <Private>true</Private>
    <Tags xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Tags>
    <UniqueMediaName>sample string 6</UniqueMediaName>
    <UserId>9ad96e38-4cf1-4ad1-b715-98fbb59bc1f8</UserId>
  </MediaItemDto>
</ArrayOfMediaItemDto>