---
title: "GET /api/entries"
method: GET
path: "/api/entries"
tags: ["EntryApi"]
---

# GET /api/entries

`GET /api/entries`

## Query parameters

- `query` string
- `tagName[]` string[]
- `tagId[]` integer[]
- `childTags` boolean
- `entryTypes` 'Nothing' | 'Album' | 'Artist' | 'DiscussionTopic' | 'PV' | 'ReleaseEvent' | 'ReleaseEventSeries' | 'Song' | 'SongList' | 'Tag' | 'User' | 'Venue'
- `status` 'Draft' | 'Finished' | 'Approved' | 'Locked'
- `start` integer
- `maxResults` integer
- `getTotalCount` boolean
- `sort` 'None' | 'Name' | 'AdditionDate' | 'ActivityDate'
- `nameMatchMode` 'Auto' | 'Partial' | 'StartsWith' | 'Exact' | 'Words'
- `fields` 'None' | 'AdditionalNames' | 'Description' | 'MainPicture' | 'Names' | 'PVs' | 'Tags' | 'WebLinks'
- `lang` 'Default' | 'Japanese' | 'Romaji' | 'English'

## Response `200`

Success

- EntryForApiContractPartialFindResult
  - `items` EntryForApiContract[], nullable
    - `activityDate` string, date-time, nullable
    - `additionalNames` string, nullable
    - `artistString` string, nullable
    - `artistType` 'Unknown' | 'Circle' | 'Label' | 'Producer' | 'Animator' | 'Illustrator' | 'Lyricist' | 'Vocaloid' | 'UTAU' | 'CeVIO' | 'OtherVoiceSynthesizer' | 'OtherVocalist' | 'OtherGroup' | 'OtherIndividual' | 'Utaite' | 'Band' | 'Vocalist' | 'Character' | 'SynthesizerV' | 'CoverArtist' | 'NEUTRINO' | 'VoiSona' | 'NewType' | 'Voiceroid' | 'Instrumentalist' | 'Designer' | 'VOICEVOX' | 'ACEVirtualSinger' | 'AIVOICE'
    - `createDate` string, date-time
    - `defaultName` string, nullable
    - `defaultNameLanguage` 'Unspecified' | 'Japanese' | 'Romaji' | 'English'
    - `description` string, nullable
    - `discType` 'Unknown' | 'Album' | 'Single' | 'EP' | 'SplitAlbum' | 'Compilation' | 'Video' | 'Artbook' | 'Game' | 'Fanmade' | 'Instrumental' | 'Other' | 'Drama'
    - `entryType` 'Undefined' | 'Album' | 'Artist' | 'DiscussionTopic' | 'PV' | 'ReleaseEvent' | 'ReleaseEventSeries' | 'Song' | 'SongList' | 'Tag' | 'User' | 'Venue'
    - `eventCategory` 'Unspecified' | 'AlbumRelease' | 'Anniversary' | 'Club' | 'Concert' | 'Contest' | 'Convention' | 'Other' | 'Festival'
    - `id` integer
    - `mainPicture` EntryThumbForApiContract
      - `mime` string, nullable
      - `name` string, nullable
      - `urlOriginal` string, nullable
      - `urlSmallThumb` string, nullable
      - `urlThumb` string, nullable
      - `urlTinyThumb` string, nullable
    - `name` string, nullable
    - `names` LocalizedStringContract[], nullable
      - `language` 'Unspecified' | 'Japanese' | 'Romaji' | 'English'
      - `value` string, nullable
    - `pvs` PVContract[], nullable
      - `author` string, nullable
      - `createdBy` integer, nullable
      - `description` string, nullable
      - `disabled` boolean
      - `extendedMetadata` PVExtendedMetadata
        - `json` string, nullable
      - `id` integer
      - `length` integer
      - `name` string, nullable
      - `publishDate` string, date-time, nullable
      - `pvId` string, nullable
      - `service` 'NicoNicoDouga' | 'Youtube' | 'SoundCloud' | 'Vimeo' | 'Piapro' | 'Bilibili' | 'File' | 'LocalFile' | 'Creofuga' | 'Bandcamp'
      - `pvType` 'Original' | 'Reprint' | 'Other'
      - `thumbUrl` string, nullable
      - `url` string, nullable
    - `songListFeaturedCategory` 'Nothing' | 'Concerts' | 'VocaloidRanking' | 'Pools' | 'Other'
    - `songType` 'Unspecified' | 'Original' | 'Remaster' | 'Remix' | 'Cover' | 'Arrangement' | 'Instrumental' | 'Mashup' | 'MusicPV' | 'DramaPV' | 'Live' | 'Illustration' | 'Other' | 'Rearrangement' | 'ShortVersion'
    - `status` 'Draft' | 'Finished' | 'Approved' | 'Locked'
    - `releaseEventSeriesName` string, nullable
    - `tagCategoryName` string, nullable
    - `tags` TagUsageForApiContract[], nullable
      - `count` integer
      - `tag` TagBaseContract
        - `additionalNames` string, nullable
        - `categoryName` string, nullable
        - `id` integer
        - `name` string, nullable
        - `urlSlug` string, nullable
    - `urlSlug` string, nullable
    - `version` integer
    - `webLinks` ArchivedWebLinkContract[], nullable
      - `category` 'Official' | 'Commercial' | 'Reference' | 'Other'
      - `description` string, nullable
      - `disabled` boolean
      - `url` string, nullable
  - `term` string, nullable
  - `totalCount` integer

---

[API](https://skmtc.net/vocadb/apis/vocadbweb.md) · [All operations](https://skmtc.net/vocadb/apis/vocadbweb/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vocadb/vocadbweb/revisions/d1328dfaa36f/schema)