Operational Purse-seine Data Format

Field formatting details

  • Datetime must be reported in ISO 8601 format: YYYY-MM-DD HH:MM:SS.
  • Latitude and longitude must be reported in decimal degrees with 3 decimals, the valid range is -180 to 180 for longitude and -90 to 90 for latitude.
    • E.g. -5.432 for latitude and 170.215 for longitude
  • Catches must be reported in metric tonnes (mt) and number of individuals (n), and must be whole values (cannot use decimal values).
  • Species code must be FAO standard Species Code (3 characters).
    • E.g. YFT - Yellowfin Tuna or ALB - Albacore Tuna.
  • Each port has a unique 5 letter code. Please refer to this document provided by WCPFC.

Documents structure and data fields format

Operational data are structured in three interconnected levels: Trip, Activity, and Catch. Separate tables are used for each data level to maintain clarity and reduce redundancy. Each table is connected using unique identifiers: trip_id for the Trip level and activity_id for the Activity level. These identifiers must be numeric or alphanumeric and unique within the set of files.

👉 Data providers can also download ready-to-use CSV data templates for each level (trip, activity, and catch).

CSV Data Templates

Trip level

This is the header of the trip, it has one row per trip.

Example document at trip level

trip_idvessel_namevessel_regircsuviflag_codefleet_codedeparture_portunloading_portdeparture_datetimeunloading_datetime
TRIP501Island Spirit5842356FHY069900125KRWSAPWWSAPW2025-03-01 05:382025-03-18 22:47

Field descriptions at trip level

Field nameTypeFormatDescriptionMandatory
trip_idStringAlphanumeric - refer to Trip level identifierUnique identifier for the tripYes
vessel_nameStringAlphanumericName of the fishing vesselYes
vessel_regStringAlphanumericRegistration number of the vesselYes*
ircsStringAlphanumericInternational radio call signYes*
uviNumberNumberUnique Vessel Identifier (reference to the IMO)No
flag_codeText2 letter flag-state code (UN/LOCODE)Authorized flag stateYes
fleet_codeText2 letter code for sub-fleet (see fleet reference table)Sub-fleet codeNo
departure_portStringWCPFC port codePort of departureYes
unloading_portStringWCPFC port codePort of unloadingYes
departure_datetimeDatetimeYYYY-MM-DD HH:MM:SSDate of departureYes
unloading_datetimeDatetimeYYYY-MM-DD HH:MM:SSDate of unloadingYes
  • = A code may be used as a vessel identifier instead of the name of the vessel, registration number and call sign for vessels that have fished and that intend to fish only in the waters of national jurisdiction of the State that has flagged the vessel

Activity level

This level contains one row per activity within a trip. At least one Activity entry should be recorded each day, and it is possible to have multiple activities in the same day.

Example document at activity level

trip_idactivity_idlatitudelongitudeactivity_type_idactivity_datetimesetend_datetimeschool_type_id
TRIP501ACT001-2.341-174.165114/02/2025 03:5014/02/2025 05:101
TRIP501ACT002-10.482-156.513116/02/2025 04:0516/02/2025 05:204

Field descriptions at activity level

Field nameTypeFormatDescriptionMandatory
trip_idStringAlphanumeric - refer to Trip level identifierUnique identifier for the tripYes
activity_idStringAlphanumeric - refer to Activity level identifierUnique identifier for the activityYes
latitudeNumberDecimal DegreesLatitude of the activity locationYes
longitudeNumberDecimal DegreesLongitude of the activity locationYes
activity_type_idNumberInteger: refer to activity reference tableType of activityYes
activity_datetimeDatetimeISO 8601 Date and time: YYYY-MM-DD HH:MM:SSDate and time of the start of the activityYes
setend_datetimeDatetimeISO 8601 Date and time: YYYY-MM-DD HH:MM:SSDate and time of the end of the activityYes
school_type_idNumberInteger: refer to school type reference tableSchool association identifierYes

* Mandatory for activity activity_type_id = 1 (Fishing Set)

Catch level

One Catch entry must be provided for each species caught during a Fishing Set, either retained or discarded. Column is_discarded indicates whether the catch was discarded (1) or retained (0).

Example document at catch level

trip_idactivity_idsp_codesp_mtsp_nis_discarded
TRIP501ACT001SKJ215000
TRIP501ACT001YFT62000
TRIP501ACT002SKJ150000
TRIP501ACT002YFT70000
TRIP501ACT002FAL0.110

Field descriptions at catch level

Field NameTypeFormatDescriptionMandatory
trip_idStringAlphanumeric - refer to Trip level identifierUnique identifier for the fishing tripYes
activity_idStringAlphanumeric - refer to Activity level identifierUnique identifier for the fishing activityYes
sp_codeStringFAO 3-letter code for the target speciesFAO 3-letter code for the target speciesYes
sp_mtNumberWeight of the catch in metric tonnesWeight of the catch in metric tonnesYes
sp_nNumberNumber of individuals discarded/releasedIntended to capture discards/releases, including SSIsNo
is_discardedNumberdiscarded (1) or retained (0)Indicator of whether the catch was discarded (1) or retained (0)No

References

Reference Table 1: Activity Type identifiers

activity_type_idDescription
1Fishing Set
2Searching
3Transit
4No fishing - Breakdown/other issues
5No fishing - Bad weather
6No fishing - In port

Reference Table 2: School Type identifiers

school_type_idDescription
1Unassociated/free school
2Feeding on baitfish
3Drifting log, debris or dead animal
4Drifting raft, FAD or payao
5Anchored raft, FAD or payao
6Live whale
7Live whale shark
8Other

Reference Table 3: List of Fleets

country_codefleet_codegear_codeis_activeocean_codesdescription
AUAFS1WX,SP,SX,WPAustralia purse seine, inside the Australian Fishing Zone
AUAUL1WX,SP,SX,WPAustralia domestic and chartered longline
AUEXS1WX,SP,SX,WPAustralia distant-water purse seine
AUJVL0WX,SP,SX,WPAustralian joint-venture Longline
CNDWL1SP,NP,NX,SXChina distant-water longline
IDDWS1WX,WPIndonesia distant-water purse seine
IDIDS1WX,WPIndonesia domestic purse seine
JPCSL1WX,NP,NX,WPJapan coastal fleet longline
JPCSP1WX,NP,NX,WPJapan coastal fleet pole-and-line
JPCSS1WX,NP,NX,WPJapan coastal fleet purse seine
JPDWP1WX,SP,NP,NX,WPJapan offshore and distant water pole-and-line
JPDWS1WX,SP,NP,NX,WPJapan offshore and distant-water purse seine
JPJPL1WX,SP,NP,SX,NX,WPJapan offshore and distant water longline
PHDWS1WX,WPPhilippines distant-water purse seine
PHPHS1WX,NX,WPPhilippines domestic purse seine
TWDWL1WX,SP,NP,SX,NX,WPChinese Taipei distant-water longline
TWODL0NP,NXChinese Taipei offshore domestic longline (REDUNDANT -STLL)
TWOSL1WX,SP,NP,SX,NX,WPChinese Taipei small-scale Longline (STLL)
USASL1WX,SP,NP,SX,NX,WPAmerican Samoa longline
USAST1WX,SP,SX,NX,WPAmerican Samoa (US) Troll
USGUL1WX,NP,NX,WPGuam (US) Longline
USGUT1WX,SP,SX,NX,WPGuam (US) Troll
USHWH1WX,NP,NX,WPHawaii (US) Handline
USHWL1WX,SP,NP,NX,WPUnited States of America longline (Hawaii)
USHWP1SP,NP,NX,WPHawaii pole-and-line
USHWT1WX,NP,SX,NX,WPHawaii (US) Troll
USHWT1SP,NX,SX,WPHawaii (US) Troll and Handline
USMPL1WX,NP,NX,WPNorthern Marianas Islands (US) Longline
USMPT1WX,SP,SX,NX,WPNorthern Mariana Islands (US) troll
USUSL1WX,SP,NP,NX,WPUnited States of America longline