# V1 match versus V2 match

**URL:** <https://discourse.gbif.org/t/v1-match-versus-v2-match/6030>\
**Category:** Data Use\
**Tags:** taxonomy\
**Created:** [July 30, 2025, 12:41pm UTC](https://discourse.gbif.org/t/v1-match-versus-v2-match/6030 "2025-07-30T12:41:56Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![waschulte](https://avatars.discourse-cdn.com/v4/letter/w/f6c823/32.png) [@waschulte](https://discourse.gbif.org/u/waschulte)\
**Post date:** [July 30, 2025, 12:41pm UTC](https://discourse.gbif.org/t/v1-match-versus-v2-match/6030/1 "2025-07-30T12:41:56Z")

</div>

Having a bunch of taxa (mostly (sub)species) it is useful to complete their lineage to be able to use that in selections. Problem is: when a taxon is a subspecies, the V2 version of species match gives nothing, whereas the V1 version gives the correct answer:

```auto
[type or paste code here](https://api.gbif.org/v1/species/match?name=Pycnonotus%20barbatus%20layardi&limit=20&offset=0)

```

yields the correct key (ic. 6094955) but

```auto
[type or paste code here](https://api.gbif.org/v2/species/match?name=Pycnonotus%20barbatus%20layardi&limit=20&offset=0)

```

yields no results.

I know the V1 version might disappear in the (near) future, but for now it seems that is lacks something, or do I miss a parameter ?

---

<div class="post-metadata">

**Author:** ![mgrosjean](https://avatars.discourse-cdn.com/v4/letter/m/97f17d/32.png) [@mgrosjean](https://discourse.gbif.org/u/mgrosjean)\
**Post date:** [July 31, 2025, 7:11am UTC](https://discourse.gbif.org/t/v1-match-versus-v2-match/6030/2 "2025-07-31T07:11:59Z")

</div>

Hi @waschulte

`name` isn’t one of the parameters of the V2, you need to use `scientificName` instead:

[https://api.gbif.org/v2/species/match?scientificName=Pycnonotus%20barbatus%20layardi&limit=20&offset=0](https://api.gbif.org/v2/species/match?scientificName=Pycnonotus%20barbatus%20layardi&limit=20&offset=0)

---

<div class="post-metadata">

**Author:** ![waschulte](https://avatars.discourse-cdn.com/v4/letter/w/f6c823/32.png) [@waschulte](https://discourse.gbif.org/u/waschulte)\
**Post date:** [July 31, 2025, 9:37am UTC](https://discourse.gbif.org/t/v1-match-versus-v2-match/6030/3 "2025-07-31T09:37:08Z")

</div>

Hi mgrosjean

Thanks for that. Stupid me 🫣