TL;DR our new MSC fisheries function instantly checks the status and details of Marine Stewardship Council (MSC) fisheries certificates.
2 new functions in 1 week? That’s right. We did that. We’ve been busy, heads down, working in the spreadsheet trenches so you can kick back and relax. Buried in this week's Global Fisheries API release, we easter-egged a super secret function that we're rolling out today. Officially welcoming the MSC fisheries function to the Goldfish API!
Before we get into the technicalities, let's break down why this matters and how it can help your company. Let's gooooo!!
MSC is the largest seafood ecolabel program in the world. Retailers worldwide require sourcing certified products when available, making it an important market differentiator. To carry their ecolabel, certified fisheries and supply chain actors work together to bring certified seafood from harvest to consumer. That means a lot of certificate data is moving rapidly through supply chains worldwide. Oh yea, that's a whole lotta data, bb.
Working with processors and distributors, we’ve seen that many companies require MSC fisheries certificate information (in addition to Chain of Custody certificate numbers) but don’t have the bandwidth to check every certificate on PO. Shuffling unchecked data through supply chains is risky for both buyers and suppliers, but Goldfish can help. You can use our API to instantly answer questions like:
Graduating from periodic spot checks to 100% screening is a huge relief if you have concerns about conformance, reputational risk, or just want to expedite the manual research that comes with vetting new suppliers.
The MSC fisheries function allows you to query all certified, in assessment, or previously certified fisheries. There are ~2,400 MSC fisheries across all status types (active, In Transition to MSC, withdrawn, etc.). You can retrieve detailed information about an MSC fishery, including:
You can query the API in 2 ways.
Let's try this scenario out on the sandbar. Say you want to only check the status of an MSC fishery you typically source from. You already have its fishery information (like species, harvest area, gear type, fishery name, and certificate codes) in your records. Here’s how you can use the MSC fisheries function to verify this fishery:
query searchMSCFishery($input: MSCFisheryInputParam!) {
searchMSCFishery(input: $input) {
mscFisheryStatus
}
}
{
"input": {
"mscFisheryCertCode": "MSC-F-30024"
}
}Example of how to write your MSC input query using an MSC fishery certificate code. You can test this exact example on the Sandbar.
The result below is crystal clear, this fishery is certified. The mscFisheryStatus provides one of the following responses: Certified; In Assessment; In-transition to MSC; Not certified; Suspended; Withdrawn.
{
"data": {
"searchMSCFishery": [
{
"mscFisheryStatus": "Certified"
}
]
}
}
An example of a quick and easy result from the MSC fishery query.
Let’s try a second scenario on the sandbar. Your company is considering working with a new supplier, and you want to ensure they’re sourcing from an MSC-certified fishery. You don’t know any MSC fishery details like the certificate code or fishery name. However, you know the fishery operates in FAO Ocean Area 51 and catches St. Paul rock lobster (Jasus paulensis) using pots. Here’s how you can use the MSC fisheries function to verify this fishery:
query searchMSCFishery($input: MSCFisheryInputParam!) {
searchMSCFishery(input: $input) {
mscFisheryStatus
mscFisheryDetails
}
}
{
"input": {
"speciesScientific": "Jasus paulensis",
"harvestAreaFAO": "51",
"gearType": "pots"
}
}Example of how to write your MSC input query using fishery parameters. You can test this exact example on the Sandbar.
In the API result, you can view the status and details of the MSC fishery. The fishery details contain all of the additional information relevant to that fishery, such as codes (you know we love them) and alternate formats, as well as the MSC fishery name and certificate codes that allow you to follow up with MSC or your soon-to-be suppliers.
{
"data": {
"searchMSCFishery": [
{
"mscFisheryStatus": "Certified",
"mscFisheryDetails": {
"mscFisheryName": "Southern Indian Ocean Saint Paul Rock Lobster Fishery",
"mscFisheryCertCode": [
"MSC-F-31472"
],
"species": {
"scientificName": [
"Jasus paulensis"
],
"speciesMSC": [
"St.paul rock lobster"
],
"alpha3Code": "JSP"
},
"gearType": [
{
"mscGear": "Traps - Pots",
"faoName": "Pots",
"faoAlpha": "FPO",
"faoISSCFG": "08.2"
}
],
"harvestArea": {
"harvestAreaFAO": [
{
"faoCode": "51",
"faoName": "Indian Ocean, Western"
}
]
}
}
}
]
}
}
Example of a result from the MSC Fishery Query that displays all of the fishery status and details. You can test this exact example on the Sandbar.
There's still a party on the Sandbar, and the MSC fisheries function just arrived. Head over to https://sandbar.goldfish.io/graphql to test, play, and get some sand in your toes. Maybe we'll even play some beach volleyball, but tbh you'll probs lose.
The API documentation is updated here, and as the one who's responsible for writing it, you guys better freaking appreciate it!
Yes, the new function is live for all current Goldfish users. Head to the playground and check it out.
TTFN, the Goldfish Product Team
Do you have questions, or want some 1-on-1 time with our sales bros? Reach out to the boys at sales@goldfish.io.
Don’t know what an API is, but like our vibe? You might be perfect for our new Alpha tester program. Contact hello@goldfish.io, and we’ll chat.